Changes in uspace/lib/nettl/src/portrng.c [8a637a4:c3f7d37] in mainline

File:

• uspace/lib/nettl/src/portrng.c (modified) (7 diffs)

uspace/lib/nettl/src/portrng.c

@@ -46 +46 @@
 #include <io/log.h>
 
-/** Create port range.
- *
- * @param rpr Place to store pointer to new port range
- * @return EOK on success, ENOMEM if out of memory
- */
 int portrng_create(portrng_t **rpr)
 {
@@ -67 +62 @@
 }
 
-/** Destroy port range.
- *
- * @param pr Port range
- */
 void portrng_destroy(portrng_t *pr)
 {
@@ -78 +69 @@
 }
 
-/** Allocate port number from port range.
- *
- * @param pr    Port range
- * @param pnum  Port number to allocate specific port, or zero to allocate
- *              any valid port from range
- * @param arg   User argument to set for port
- * @param flags Flags, @c pf_allow_system to allow ports from system range
- *              to be specified by @a pnum.
- * @param apnum Place to store allocated port number
- *
- * @return EOK on success, ENOENT if no free port number found, EEXIST
- *         if @a pnum is specified but it is already allocated,
- *         EINVAL if @a pnum is specified from the system range, but
- *         @c pf_allow_system was not set.
- */
 int portrng_alloc(portrng_t *pr, uint16_t pnum, void *arg,
     portrng_flags_t flags, uint16_t *apnum)
@@ -137 +113 @@
                         if (port->pn == pnum) {
                                 log_msg(LOG_DEFAULT, LVL_DEBUG2, "port already used");
-                                return EEXIST;
+                                return EEXISTS;
                         }
                 }
@@ -155 +131 @@
 }
 
-/** Find allocated port number and return its argument.
- *
- * @param pr   Port range
- * @param pnum Port number
- * @param rarg Place to store user argument
- *
- * @return EOK on success, ENOENT if specified port number is not allocated
- */
 int portrng_find_port(portrng_t *pr, uint16_t pnum, void **rarg)
 {
@@ -175 +143 @@
 }
 
-/** Free port in port range.
- *
- * @param pr   Port range
- * @param pnum Port number
- */
 void portrng_free_port(portrng_t *pr, uint16_t pnum)
 {
@@ -195 +158 @@
 }
 
-/** Determine if port range is empty.
- *
- * @param pr Port range
- * @return @c true if no ports are allocated from @a pr, @c false otherwise
- */
 bool portrng_empty(portrng_t *pr)
 {