Author: biurrun Date: Mon Apr 19 16:11:07 2010 New Revision: 2302 Log: Add doxygen documentation for undocumented function parameters. Modified: trunk/community-operator/co_client.c trunk/community-operator/hipl.c trunk/libpisa/nat.c trunk/libpisa/pisaconf.c trunk/pairing/pisaum/include/management.php Modified: trunk/community-operator/co_client.c ============================================================================== --- trunk/community-operator/co_client.c Mon Apr 19 14:48:06 2010 (r2301) +++ trunk/community-operator/co_client.c Mon Apr 19 16:11:07 2010 (r2302) @@ -209,7 +209,9 @@ /** * Terminate community-operator client by receiving signal - * @param sig signal quit code + * @param sig signal quit code + * @param info unused + * @param ctx unused */ static void co_client_quit(UNUSED int sig, UNUSED siginfo_t *info, UNUSED void *ctx) Modified: trunk/community-operator/hipl.c ============================================================================== --- trunk/community-operator/hipl.c Mon Apr 19 14:48:06 2010 (r2301) +++ trunk/community-operator/hipl.c Mon Apr 19 16:11:07 2010 (r2302) @@ -77,6 +77,7 @@ * Set the total length of a HIP packet. * * @param msg HIP message + * @param len packet length */ static void hip_set_msg_total_len(struct hip_common *msg, uint16_t len) { Modified: trunk/libpisa/nat.c ============================================================================== --- trunk/libpisa/nat.c Mon Apr 19 14:48:06 2010 (r2301) +++ trunk/libpisa/nat.c Mon Apr 19 16:11:07 2010 (r2302) @@ -119,6 +119,7 @@ /** * Find a NAT mapping based on the remote HIT and the remote IPv4 address. + * @param natlist list of NAT mappings * @param remote_hit remote HIT * @param remote_ipv4 remote IPV4 * @return NAT mapping entry @@ -138,6 +139,7 @@ /** * Find a NAT mapping based on a local private IPv4 address. + * @param natlist list of NAT mappings * @param local_private local private IPv4 address * @return NAT mapping entry */ @@ -261,6 +263,7 @@ /** * Remove all NAT mappings for a given HIT from the list. + * @param natlist list of NAT mappings * @param remote_hit the remote public IPv6 address (HIT) */ void pisa_nat_del_mappings_for_hit(struct pisa_nat_list *natlist, @@ -280,6 +283,7 @@ /** * Update the connection for a NAT mapping. Used when a legacy client had a * handover, so we know where to route packets for that client. + * @param natlist list of NAT mappings * @param map mapping that needs to be updated * @param entry the new connection for that mapping * @param src new source IP address for the legacy client Modified: trunk/libpisa/pisaconf.c ============================================================================== --- trunk/libpisa/pisaconf.c Mon Apr 19 14:48:06 2010 (r2301) +++ trunk/libpisa/pisaconf.c Mon Apr 19 16:11:07 2010 (r2302) @@ -412,6 +412,7 @@ * Read a file and interpret each line as arguments to a pisa{s,c}dconf * command. * @param filename name of the file containing the configuration + * @param parse callback function that does the actual parsing */ void pisa_conf_read_file(const char *filename, pisa_conf_parse_cb parse) { Modified: trunk/pairing/pisaum/include/management.php ============================================================================== --- trunk/pairing/pisaum/include/management.php Mon Apr 19 14:48:06 2010 (r2301) +++ trunk/pairing/pisaum/include/management.php Mon Apr 19 16:11:07 2010 (r2302) @@ -150,6 +150,7 @@ * Adds a new entry to the configuration file * * @param hit The HIT of the new entry + * @param expires expiration date or 1 for default expiration date * @param username The name of the user * (can be NULL if only a HIT-entry should be added) * @param active The active status of the user @@ -300,7 +301,7 @@ * 0: inactive * 1: active * 2: no change - * @param expires The new expiration date or 1 for default expiration date + * @param expiration The new expiration date or 1 for default expiration date */ public function changeActive($username=NULL,$hit=NULL,$active=2,$expiration=1) {