Changeset ca2d142 in mainline for uspace/srv/net/structures/packet/packet.h

Timestamp:

2010-02-18T10:00:30Z (14 years ago)

Author:

Jakub Jermar <jakub@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

e326edc

Parents:

b8da2a3 (diff), 91478aa (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge from the networking branch.

File:

• uspace/srv/net/structures/packet/packet.h (modified) (2 diffs)

uspace/srv/net/structures/packet/packet.h

@@ -53 +53 @@
 typedef packet_t *              packet_ref;
 
+/** Type definition of the packet dimension.
+ *  @see packet_dimension
+ */
+typedef struct packet_dimension packet_dimension_t;
+
+/** Type definition of the packet dimension pointer.
+ *  @see packet_dimension
+ */
+typedef packet_dimension_t *    packet_dimension_ref;
+
+/** Packet dimension.
+ */
+struct packet_dimension{
+        /** Reserved packet prefix length.
+         */
+        size_t                  prefix;
+        /** Maximal packet content length.
+         */
+        size_t                  content;
+        /** Reserved packet suffix length.
+         */
+        size_t                  suffix;
+        /** Maximal packet address length.
+         */
+        size_t                  addr_len;
+};
+
 /** @name Packet management system interface
  */
@@ -86 +113 @@
  *  The queue is sorted in the ascending order.
  *  The packet is inserted right before the packets of the same order value.
- *  @param[in] first The first packet of the queue. May be NULL.
+ *  @param[in,out] first The first packet of the queue. Sets the first packet of the queue. The original first packet may be shifted by the new packet.
  *  @param[in] packet The packet to be added.
  *  @param[in] order The packet order value.
  *  @param[in] metric The metric value of the packet.
- *  @returns The first packet of the queue. The original first packet may be shifted by the new packet.
- *  @returns NULL if the packet is not valid.
+ *  @returns EOK on success.
+ *  @returns EINVAL if the first parameter is NULL.
+ *  @returns EINVAL if the packet is not valid.
  */
-packet_t        pq_add( packet_t first, packet_t packet, size_t order, size_t metric );
+int     pq_add( packet_t * first, packet_t packet, size_t order, size_t metric );
 
 /** Finds the packet with the given order.