Merge remote-tracking branch 'origin/master' into ieee802154

net/arp/arp.h

@@ -188,7 +188,7 @@ struct arp_notify_s
 void arp_reset(void);
 
 /****************************************************************************
- * Function: arp_timer_initialize
+ * Name: arp_timer_initialize
  *
  * Description:
  *   Initialized the 10 second timer that is need by the ARP logic in order
@@ -239,7 +239,7 @@ struct net_driver_s; /* Forward reference */
 void arp_format(FAR struct net_driver_s *dev, in_addr_t ipaddr);
 
 /****************************************************************************
- * Function: arp_send
+ * Name: arp_send
  *
  * Description:
  *   The arp_send() call may be to send an ARP request to resolve an IPv4
@@ -274,7 +274,7 @@ int arp_send(in_addr_t ipaddr);
 #endif
 
 /****************************************************************************
- * Function: arp_poll
+ * Name: arp_poll
  *
  * Description:
  *   Poll all pending transfer for ARP requests to send.
@@ -293,7 +293,7 @@ int arp_poll(FAR struct net_driver_s *dev, devif_poll_callback_t callback);
 #endif
 
 /****************************************************************************
- * Function: arp_wait_setup
+ * Name: arp_wait_setup
  *
  * Description:
  *   Called BEFORE an ARP request is sent.  This function sets up the ARP
@@ -313,7 +313,7 @@ void arp_wait_setup(in_addr_t ipaddr, FAR struct arp_notify_s *notify);
 #endif
 
 /****************************************************************************
- * Function: arp_wait_cancel
+ * Name: arp_wait_cancel
  *
  * Description:
  *   Cancel any wait set after arp_wait_setup is called but before arm_wait()
@@ -332,7 +332,7 @@ int arp_wait_cancel(FAR struct arp_notify_s *notify);
 #endif
 
 /****************************************************************************
- * Function: arp_wait
+ * Name: arp_wait
  *
  * Description:
  *   Called each time that a ARP request is sent.  This function will sleep
@@ -353,7 +353,7 @@ int arp_wait(FAR struct arp_notify_s *notify, FAR struct timespec *timeout);
 #endif
 
 /****************************************************************************
- * Function: arp_notify
+ * Name: arp_notify
  *
  * Description:
  *   Called each time that a ARP response is received in order to wake-up

net/arp/arp_notify.c

@@ -68,7 +68,7 @@ static FAR struct arp_notify_s *g_arp_waiters;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: arp_wait_setup
+ * Name: arp_wait_setup
  *
  * Description:
  *   Called BEFORE an ARP request is sent.  This function sets up the ARP
@@ -106,7 +106,7 @@ void arp_wait_setup(in_addr_t ipaddr, FAR struct arp_notify_s *notify)
 }
 
 /****************************************************************************
- * Function: arp_wait_cancel
+ * Name: arp_wait_cancel
  *
  * Description:
  *   Cancel any wait set after arp_wait_setup is called but before arp_wait()
@@ -155,7 +155,7 @@ int arp_wait_cancel(FAR struct arp_notify_s *notify)
 }
 
 /****************************************************************************
- * Function: arp_wait
+ * Name: arp_wait
  *
  * Description:
  *   Called each time that a ARP request is sent.  This function will sleep
@@ -220,7 +220,7 @@ int arp_wait(FAR struct arp_notify_s *notify, FAR struct timespec *timeout)
 }
 
 /****************************************************************************
- * Function: arp_notify
+ * Name: arp_notify
  *
  * Description:
  *   Called each time that a ARP response is received in order to wake-up

net/arp/arp_poll.c

@@ -53,7 +53,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: arp_poll
+ * Name: arp_poll
  *
  * Description:
  *   Poll all pending transfer for ARP requests to send.

net/arp/arp_send.c

@@ -75,7 +75,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: arp_send_terminate
+ * Name: arp_send_terminate
  ****************************************************************************/
 
 static void arp_send_terminate(FAR struct arp_send_s *state, int result)
@@ -94,7 +94,7 @@ static void arp_send_terminate(FAR struct arp_send_s *state, int result)
 }
 
 /****************************************************************************
- * Function: arp_send_interrupt
+ * Name: arp_send_interrupt
  ****************************************************************************/
 
 static uint16_t arp_send_interrupt(FAR struct net_driver_s *dev,
@@ -158,7 +158,7 @@ static uint16_t arp_send_interrupt(FAR struct net_driver_s *dev,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: arp_send
+ * Name: arp_send
  *
  * Description:
  *   The arp_send() call may be to send an ARP request to resolve an IP

net/arp/arp_timer.c

@@ -72,7 +72,7 @@ static WDOG_ID g_arptimer;           /* ARP timer */
  ****************************************************************************/
 
 /****************************************************************************
- * Function: arptimer_poll
+ * Name: arptimer_poll
  *
  * Description:
  *   Periodic timer handler.  Called from the timer interrupt handler.
@@ -104,7 +104,7 @@ static void arptimer_poll(int argc, wdparm_t arg, ...)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: arp_timer_initialize
+ * Name: arp_timer_initialize
  *
  * Description:
  *   Initialized the 10 second timer that is need by the ARP logic in order

net/devif/devif.h

@@ -297,7 +297,7 @@ extern "C"
 void devif_initialize(void);
 
 /****************************************************************************
- * Function: devif_callback_init
+ * Name: devif_callback_init
  *
  * Description:
  *   Configure the pre-allocated callback structures into a free list.
@@ -310,7 +310,7 @@ void devif_initialize(void);
 void devif_callback_init(void);
 
 /****************************************************************************
- * Function: devif_callback_alloc
+ * Name: devif_callback_alloc
  *
  * Description:
  *   Allocate a callback container from the free list.
@@ -330,7 +330,7 @@ FAR struct devif_callback_s *
                        FAR struct devif_callback_s **list);
 
 /****************************************************************************
- * Function: devif_conn_callback_free
+ * Name: devif_conn_callback_free
  *
  * Description:
  *   Return a connection/port callback container to the free list.
@@ -352,7 +352,7 @@ void devif_conn_callback_free(FAR struct net_driver_s *dev,
                               FAR struct devif_callback_s **list);
 
 /****************************************************************************
- * Function: devif_dev_callback_free
+ * Name: devif_dev_callback_free
  *
  * Description:
  *   Return a device callback container to the free list.
@@ -375,7 +375,7 @@ void devif_dev_callback_free(FAR struct net_driver_s *dev,
                              FAR struct devif_callback_s *cb);
 
 /****************************************************************************
- * Function: devif_conn_event
+ * Name: devif_conn_event
  *
  * Description:
  *   Execute a list of callbacks.
@@ -401,7 +401,7 @@ uint16_t devif_conn_event(FAR struct net_driver_s *dev, FAR void *pvconn,
                           uint16_t flags, FAR struct devif_callback_s *list);
 
 /****************************************************************************
- * Function: devif_dev_event
+ * Name: devif_dev_event
  *
  * Description:
  *   Execute a list of callbacks using the device event chain.

net/devif/devif_callback.c

@@ -64,7 +64,7 @@ static FAR struct devif_callback_s *g_cbfreelist = NULL;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: devif_callback_free
+ * Name: devif_callback_free
  *
  * Description:
  *   Return a callback container to the free list.
@@ -167,7 +167,7 @@ static void devif_callback_free(FAR struct net_driver_s *dev,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: devif_callback_init
+ * Name: devif_callback_init
  *
  * Description:
  *   Configure the pre-allocated callback structures into a free list.
@@ -189,7 +189,7 @@ void devif_callback_init(void)
 }
 
 /****************************************************************************
- * Function: devif_callback_alloc
+ * Name: devif_callback_alloc
  *
  * Description:
  *   Allocate a callback container from the free list.
@@ -267,7 +267,7 @@ FAR struct devif_callback_s *
 }
 
 /****************************************************************************
- * Function: devif_conn_callback_free
+ * Name: devif_conn_callback_free
  *
  * Description:
  *   Return a connection/port callback container to the free list.
@@ -306,7 +306,7 @@ void devif_conn_callback_free(FAR struct net_driver_s *dev,
 }
 
 /****************************************************************************
- * Function: devif_dev_callback_free
+ * Name: devif_dev_callback_free
  *
  * Description:
  *   Return a device callback container to the free list.
@@ -357,7 +357,7 @@ void devif_dev_callback_free(FAR struct net_driver_s *dev,
 }
 
 /****************************************************************************
- * Function: devif_conn_event
+ * Name: devif_conn_event
  *
  * Description:
  *   Execute a list of callbacks using the packet event chain.
@@ -421,7 +421,7 @@ uint16_t devif_conn_event(FAR struct net_driver_s *dev, void *pvconn,
 }
 
 /****************************************************************************
- * Function: devif_dev_event
+ * Name: devif_dev_event
  *
  * Description:
  *   Execute a list of callbacks using the device event chain.

net/devif/devif_poll.c

@@ -85,7 +85,7 @@ systime_t g_polltime;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: devif_packet_conversion
+ * Name: devif_packet_conversion
  *
  * Description:
  *   Generic output conversion hook.  Only needed for IEEE802.15.4 for now
@@ -157,7 +157,7 @@ static void devif_packet_conversion(FAR struct net_driver_s *dev,
 #endif /* CONFIG_NET_6LOWPAN */
 
 /****************************************************************************
- * Function: devif_poll_pkt_connections
+ * Name: devif_poll_pkt_connections
  *
  * Description:
  *   Poll all packet connections for available packets to send.
@@ -197,7 +197,7 @@ static int devif_poll_pkt_connections(FAR struct net_driver_s *dev,
 #endif /* CONFIG_NET_PKT */
 
 /****************************************************************************
- * Function: devif_poll_icmp
+ * Name: devif_poll_icmp
  *
  * Description:
  *   Poll all of the connections waiting to send an ICMP ECHO request
@@ -223,7 +223,7 @@ static inline int devif_poll_icmp(FAR struct net_driver_s *dev,
 #endif /* CONFIG_NET_ICMP && CONFIG_NET_ICMP_PING */
 
 /****************************************************************************
- * Function: devif_poll_icmpv6
+ * Name: devif_poll_icmpv6
  *
  * Description:
  *   Poll all of the connections waiting to send an ICMPv6 ECHO request
@@ -249,7 +249,7 @@ static inline int devif_poll_icmpv6(FAR struct net_driver_s *dev,
 #endif /* CONFIG_NET_ICMPv6_PING || CONFIG_NET_ICMPv6_NEIGHBOR*/
 
 /****************************************************************************
- * Function: devif_poll_igmp
+ * Name: devif_poll_igmp
  *
  * Description:
  *   Poll all IGMP connections for available packets to send.
@@ -279,7 +279,7 @@ static inline int devif_poll_igmp(FAR struct net_driver_s *dev,
 #endif /* CONFIG_NET_IGMP */
 
 /****************************************************************************
- * Function: devif_poll_udp_connections
+ * Name: devif_poll_udp_connections
  *
  * Description:
  *   Poll all UDP connections for available packets to send.
@@ -319,7 +319,7 @@ static int devif_poll_udp_connections(FAR struct net_driver_s *dev,
 #endif /* NET_UDP_HAVE_STACK */
 
 /****************************************************************************
- * Function: devif_poll_tcp_connections
+ * Name: devif_poll_tcp_connections
  *
  * Description:
  *   Poll all UDP connections for available packets to send.
@@ -361,7 +361,7 @@ static inline int devif_poll_tcp_connections(FAR struct net_driver_s *dev,
 #endif
 
 /****************************************************************************
- * Function: devif_poll_tcp_timer
+ * Name: devif_poll_tcp_timer
  *
  * Description:
  *   The TCP timer has expired.  Update TCP timing state in each active,
@@ -409,7 +409,7 @@ static inline int devif_poll_tcp_timer(FAR struct net_driver_s *dev,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: devif_poll
+ * Name: devif_poll
  *
  * Description:
  *   This function will traverse each active network connection structure and
@@ -513,7 +513,7 @@ int devif_poll(FAR struct net_driver_s *dev, devif_poll_callback_t callback)
 }
 
 /****************************************************************************
- * Function: devif_timer
+ * Name: devif_timer
  *
  * Description:
  *   These function will traverse each active network connection structure and

net/devif/ipv4_input.c

@@ -140,7 +140,7 @@ static uint8_t g_reassembly_flags;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: devif_reassembly
+ * Name: devif_reassembly
  *
  * Description:
  *   IP fragment reassembly: not well-tested.
@@ -302,7 +302,7 @@ nullreturn:
  ****************************************************************************/
 
 /****************************************************************************
- * Function: ipv4_input
+ * Name: ipv4_input
  *
  * Description:
  *

net/devif/ipv6_input.c

@@ -114,7 +114,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: ipv6_input
+ * Name: ipv6_input
  *
  * Description:
  *

net/devif/net_setipid.c

@@ -58,7 +58,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_setipid
+ * Name: net_setipid
  *
  * Description:
  *   This function may be used at boot time to set the initial ip_id.

net/icmp/icmp_ping.c

@@ -99,7 +99,7 @@ struct icmp_ping_s
  ****************************************************************************/
 
 /****************************************************************************
- * Function: ping_timeout
+ * Name: ping_timeout
  *
  * Description:
  *   Check for send timeout.
@@ -127,7 +127,7 @@ static inline int ping_timeout(FAR struct icmp_ping_s *pstate)
 }
 
 /****************************************************************************
- * Function: ping_interrupt
+ * Name: ping_interrupt
  *
  * Description:
  *   This function is called from the interrupt level to perform the actual

net/icmpv6/icmpv6.h

@@ -290,7 +290,7 @@ void icmpv6_radvertise(FAR struct net_driver_s *dev);
 #endif
 
 /****************************************************************************
- * Function: icmpv6_wait_setup
+ * Name: icmpv6_wait_setup
  *
  * Description:
  *   Called BEFORE an Neighbor Solicitation is sent.  This function sets up
@@ -311,7 +311,7 @@ void icmpv6_wait_setup(const net_ipv6addr_t ipaddr,
 #endif
 
 /****************************************************************************
- * Function: icmpv6_wait_cancel
+ * Name: icmpv6_wait_cancel
  *
  * Description:
  *   Cancel any wait set after icmpv6_wait_setup is called but before
@@ -331,7 +331,7 @@ int icmpv6_wait_cancel(FAR struct icmpv6_notify_s *notify);
 #endif
 
 /****************************************************************************
- * Function: icmpv6_wait
+ * Name: icmpv6_wait
  *
  * Description:
  *   Called each time that a Neighbor Solicitation is sent.  This function
@@ -353,7 +353,7 @@ int icmpv6_wait(FAR struct icmpv6_notify_s *notify,
 #endif
 
 /****************************************************************************
- * Function: icmpv6_notify
+ * Name: icmpv6_notify
  *
  * Description:
  *   Called each time that a Neighbor Advertisement is received in order to
@@ -393,7 +393,7 @@ int icmpv6_autoconfig(FAR struct net_driver_s *dev);
 #endif
 
 /****************************************************************************
- * Function: icmpv6_rwait_setup
+ * Name: icmpv6_rwait_setup
  *
  * Description:
  *   Called BEFORE an Router Solicitation is sent.  This function sets up
@@ -415,7 +415,7 @@ void icmpv6_rwait_setup(FAR struct net_driver_s *dev,
 #endif
 
 /****************************************************************************
- * Function: icmpv6_rwait_cancel
+ * Name: icmpv6_rwait_cancel
  *
  * Description:
  *   Cancel any wait set after icmpv6_rwait_setup() is called but before
@@ -435,7 +435,7 @@ int icmpv6_rwait_cancel(FAR struct icmpv6_rnotify_s *notify);
 #endif
 
 /****************************************************************************
- * Function: icmpv6_rwait
+ * Name: icmpv6_rwait
  *
  * Description:
  *   Called each time that a Router Solicitation is sent.  This function
@@ -457,7 +457,7 @@ int icmpv6_rwait(FAR struct icmpv6_rnotify_s *notify,
 #endif
 
 /****************************************************************************
- * Function: icmpv6_rnotify
+ * Name: icmpv6_rnotify
  *
  * Description:
  *   Called each time that a Router Advertisement is received in order to

net/icmpv6/icmpv6_notify.c

@@ -80,7 +80,7 @@ static struct icmpv6_notify_s *g_icmpv6_waiters;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: icmpv6_wait_setup
+ * Name: icmpv6_wait_setup
  *
  * Description:
  *   Called BEFORE an Neighbor Solicitation is sent.  This function sets up
@@ -119,7 +119,7 @@ void icmpv6_wait_setup(const net_ipv6addr_t ipaddr,
 }
 
 /****************************************************************************
- * Function: icmpv6_wait_cancel
+ * Name: icmpv6_wait_cancel
  *
  * Description:
  *   Cancel any wait set after icmpv6_wait_setup is called but before
@@ -169,7 +169,7 @@ int icmpv6_wait_cancel(FAR struct icmpv6_notify_s *notify)
 }
 
 /****************************************************************************
- * Function: icmpv6_wait
+ * Name: icmpv6_wait
  *
  * Description:
  *   Called each time that a Neighbor Solicitation is sent.  This function
@@ -224,7 +224,7 @@ int icmpv6_wait(FAR struct icmpv6_notify_s *notify,
 }
 
 /****************************************************************************
- * Function: icmpv6_notify
+ * Name: icmpv6_notify
  *
  * Description:
  *   Called each time that a Neighbor Advertisement is received in order to

net/icmpv6/icmpv6_ping.c

@@ -110,7 +110,7 @@ struct icmpv6_ping_s
  ****************************************************************************/
 
 /****************************************************************************
- * Function: ping_timeout
+ * Name: ping_timeout
  *
  * Description:
  *   Check for send timeout.
@@ -228,7 +228,7 @@ static void icmpv6_echo_request(FAR struct net_driver_s *dev,
 }
 
 /****************************************************************************
- * Function: ping_interrupt
+ * Name: ping_interrupt
  *
  * Description:
  *   This function is called from the interrupt level to perform the actual

net/icmpv6/icmpv6_rnotify.c

@@ -79,7 +79,7 @@ static struct icmpv6_rnotify_s *g_icmpv6_rwaiters;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: icmpv6_setaddresses
+ * Name: icmpv6_setaddresses
  *
  * Description:
  *   We successfully obtained the Router Advertisement.  See the new IPv6
@@ -143,7 +143,7 @@ static void icmpv6_setaddresses(FAR struct net_driver_s *dev,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: icmpv6_rwait_setup
+ * Name: icmpv6_rwait_setup
  *
  * Description:
  *   Called BEFORE an Router Solicitation is sent.  This function sets up
@@ -204,7 +204,7 @@ void icmpv6_rwait_setup(FAR struct net_driver_s *dev,
 }
 
 /****************************************************************************
- * Function: icmpv6_rwait_cancel
+ * Name: icmpv6_rwait_cancel
  *
  * Description:
  *   Cancel any wait set after icmpv6_rwait_setup() is called but before
@@ -269,7 +269,7 @@ int icmpv6_rwait_cancel(FAR struct icmpv6_rnotify_s *notify)
 }
 
 /****************************************************************************
- * Function: icmpv6_rwait
+ * Name: icmpv6_rwait
  *
  * Description:
  *   Called each time that a Router Solicitation is sent.  This function
@@ -326,7 +326,7 @@ int icmpv6_rwait(FAR struct icmpv6_rnotify_s *notify,
 }
 
 /****************************************************************************
- * Function: icmpv6_rnotify
+ * Name: icmpv6_rnotify
  *
  * Description:
  *   Called each time that a Router Advertisement is received in order to

net/local/local.h

@@ -321,7 +321,7 @@ int local_release(FAR struct local_conn_s *conn);
 int local_listen(FAR struct local_conn_s *server, int backlog);
 
 /****************************************************************************
- * Function: psock_local_accept
+ * Name: psock_local_accept
  *
  * Description:
  *   This function implements accept() for Unix domain sockets.  See the
@@ -371,7 +371,7 @@ ssize_t psock_local_send(FAR struct socket *psock, FAR const void *buf,
 #endif
 
 /****************************************************************************
- * Function: psock_local_sendto
+ * Name: psock_local_sendto
  *
  * Description:
  *   This function implements the Unix domain-specific logic of the
@@ -421,7 +421,7 @@ ssize_t psock_local_sendto(FAR struct socket *psock, FAR const void *buf,
 int local_send_packet(int fd, FAR const uint8_t *buf, size_t len);
 
 /****************************************************************************
- * Function: psock_recvfrom
+ * Name: psock_recvfrom
  *
  * Description:
  *   recvfrom() receives messages from a local socket, and may be used to
@@ -646,7 +646,7 @@ void local_accept_pollnotify(FAR struct local_conn_s *conn,
 #endif
 
 /****************************************************************************
- * Function: local_pollsetup
+ * Name: local_pollsetup
  *
  * Description:
  *   Setup to monitor events on one Unix domain socket
@@ -666,7 +666,7 @@ int local_pollsetup(FAR struct socket *psock, FAR struct pollfd *fds);
 #endif
 
 /****************************************************************************
- * Function: local_pollteardown
+ * Name: local_pollteardown
  *
  * Description:
  *   Teardown monitoring of events on a Unix domain socket

net/local/local_accept.c

@@ -56,7 +56,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: local_waitlisten
+ * Name: local_waitlisten
  ****************************************************************************/
 
 static int local_waitlisten(FAR struct local_conn_s *server)
@@ -88,7 +88,7 @@ static int local_waitlisten(FAR struct local_conn_s *server)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_local_accept
+ * Name: psock_local_accept
  *
  * Description:
  *   This function implements accept() for Unix domain sockets.  See the

net/local/local_netpoll.c

@@ -54,7 +54,7 @@
 #ifdef HAVE_LOCAL_POLL
 
 /****************************************************************************
- * Function: local_accept_pollsetup
+ * Name: local_accept_pollsetup
  ****************************************************************************/
 
 #ifdef CONFIG_NET_LOCAL_STREAM
@@ -160,7 +160,7 @@ void local_accept_pollnotify(FAR struct local_conn_s *conn,
 }
 
 /****************************************************************************
- * Function: local_pollsetup
+ * Name: local_pollsetup
  *
  * Description:
  *   Setup to monitor events on one Unix domain socket
@@ -299,7 +299,7 @@ pollerr:
 }
 
 /****************************************************************************
- * Function: local_pollteardown
+ * Name: local_pollteardown
  *
  * Description:
  *   Teardown monitoring of events on a Unix domain socket

net/local/local_recvfrom.c

@@ -120,7 +120,7 @@ static int psock_fifo_read(FAR struct socket *psock, FAR void *buf,
 }
 
 /****************************************************************************
- * Function: psock_stream_recvfrom
+ * Name: psock_stream_recvfrom
  *
  * Description:
  *   psock_stream_recvfrom() receives messages from a local stream socket.
@@ -216,7 +216,7 @@ psock_stream_recvfrom(FAR struct socket *psock, FAR void *buf, size_t len,
 #endif /* CONFIG_NET_LOCAL_STREAM */
 
 /****************************************************************************
- * Function: psock_dgram_recvfrom
+ * Name: psock_dgram_recvfrom
  *
  * Description:
  *   psock_dgram_recvfrom() receives messages from a local datagram socket.
@@ -387,7 +387,7 @@ errout_with_halfduplex:
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_local_recvfrom
+ * Name: psock_local_recvfrom
  *
  * Description:
  *   psock_local_recvfrom() receives messages from a local socket and may be

net/local/local_sendto.c

@@ -57,7 +57,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_local_sendto
+ * Name: psock_local_sendto
  *
  * Description:
  *   This function implements the Unix domain-specific logic of the

net/netdev/netdev.h

@@ -86,7 +86,7 @@ void netdev_ifup(FAR struct net_driver_s *dev);
 void netdev_ifdown(FAR struct net_driver_s *dev);
 
 /****************************************************************************
- * Function: netdev_verify
+ * Name: netdev_verify
  *
  * Description:
  *   Verify that the specified device still exists
@@ -99,7 +99,7 @@ void netdev_ifdown(FAR struct net_driver_s *dev);
 bool netdev_verify(FAR struct net_driver_s *dev);
 
 /****************************************************************************
- * Function: netdev_findbyname
+ * Name: netdev_findbyname
  *
  * Description:
  *   Find a previously registered network device using its assigned
@@ -121,7 +121,7 @@ FAR struct net_driver_s *netdev_findbyname(FAR const char *ifname);
 #endif
 
 /****************************************************************************
- * Function: netdev_findby_ipv4addr
+ * Name: netdev_findby_ipv4addr
  *
  * Description:
  *   Find a previously registered network device by matching an arbitrary
@@ -151,7 +151,7 @@ FAR struct net_driver_s *netdev_findby_ipv4addr(in_addr_t ripaddr);
 #endif
 
 /****************************************************************************
- * Function: netdev_findby_ipv6addr
+ * Name: netdev_findby_ipv6addr
  *
  * Description:
  *   Find a previously registered network device by matching an arbitrary
@@ -181,7 +181,7 @@ FAR struct net_driver_s *netdev_findby_ipv6addr(const net_ipv6addr_t ripaddr);
 #endif
 
 /****************************************************************************
- * Function: netdev_findbyindex
+ * Name: netdev_findbyindex
  *
  * Description:
  *   Find a previously registered network device by its position in the
@@ -205,7 +205,7 @@ FAR struct net_driver_s *netdev_findby_ipv6addr(const net_ipv6addr_t ripaddr);
 FAR struct net_driver_s *netdev_findbyindex(int index);
 
 /****************************************************************************
- * Function: netdev_default
+ * Name: netdev_default
  *
  * Description:
  *   Return the default network device.  REVISIT:  At present this function
@@ -233,7 +233,7 @@ FAR struct net_driver_s *netdev_default(void);
 #endif
 
 /****************************************************************************
- * Function: netdev_ipv4_txnotify
+ * Name: netdev_ipv4_txnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv4 address that new TX
@@ -261,7 +261,7 @@ void netdev_ipv4_txnotify(in_addr_t ripaddr);
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: netdev_ipv6_txnotify
+ * Name: netdev_ipv6_txnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv4 address that new TX
@@ -290,7 +290,7 @@ void netdev_ipv6_txnotify(FAR const net_ipv6addr_t ripaddr);
 #endif /* CONFIG_NSOCKET_DESCRIPTORS > 0 */
 
 /****************************************************************************
- * Function: netdev_txnotify_dev
+ * Name: netdev_txnotify_dev
  *
  * Description:
  *   Notify the device driver that new TX data is available.  This variant
@@ -311,7 +311,7 @@ void netdev_ipv6_txnotify(FAR const net_ipv6addr_t ripaddr);
 void netdev_txnotify_dev(FAR struct net_driver_s *dev);
 
 /****************************************************************************
- * Function: netdev_ipv4_rxnotify
+ * Name: netdev_ipv4_rxnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv4 address that the
@@ -340,7 +340,7 @@ void netdev_ipv4_rxnotify(in_addr_t ripaddr);
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: netdev_ipv6_rxnotify
+ * Name: netdev_ipv6_rxnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv6 address that the
@@ -386,7 +386,7 @@ void netdev_ipv6_rxnotify(FAR const net_ipv6addr_t ripaddr);
 #endif
 
 /****************************************************************************
- * Function: netdev_count
+ * Name: netdev_count
  *
  * Description:
  *   Return the number of network devices

net/netdev/netdev_carrier.c

@@ -59,7 +59,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_carrier_on
+ * Name: netdev_carrier_on
  *
  * Description:
  *   Notifies the networking layer about an available carrier.
@@ -85,7 +85,7 @@ int netdev_carrier_on(FAR struct net_driver_s *dev)
 }
 
 /****************************************************************************
- * Function: netdev_carrier_off
+ * Name: netdev_carrier_off
  *
  * Description:
  *   Notifies the networking layer about an disappeared carrier.

net/netdev/netdev_count.c

@@ -53,7 +53,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_count
+ * Name: netdev_count
  *
  * Description:
  *   Return the number of network devices

net/netdev/netdev_default.c

@@ -50,7 +50,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_default
+ * Name: netdev_default
  *
  * Description:
  *   Return the default network device.  REVISIT:  At present this function

net/netdev/netdev_findbyaddr.c

@@ -60,7 +60,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_finddevice_ipv4addr
+ * Name: netdev_finddevice_ipv4addr
  *
  * Description:
  *   Find a previously registered network device by matching a local address
@@ -113,7 +113,7 @@ static FAR struct net_driver_s *netdev_finddevice_ipv4addr(in_addr_t ripaddr)
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: netdev_finddevice_ipv6addr
+ * Name: netdev_finddevice_ipv6addr
  *
  * Description:
  *   Find a previously registered network device by matching a local address
@@ -171,7 +171,7 @@ netdev_finddevice_ipv6addr(const net_ipv6addr_t ripaddr)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_findby_ipv4addr
+ * Name: netdev_findby_ipv4addr
  *
  * Description:
  *   Find a previously registered network device by matching an arbitrary
@@ -293,7 +293,7 @@ FAR struct net_driver_s *netdev_findby_ipv4addr(in_addr_t ripaddr)
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: netdev_findby_ipv6addr
+ * Name: netdev_findby_ipv6addr
  *
  * Description:
  *   Find a previously registered network device by matching an arbitrary

net/netdev/netdev_findbyindex.c

@@ -53,7 +53,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_findbyindex
+ * Name: netdev_findbyindex
  *
  * Description:
  *   Find a previously registered network device by its position in the

net/netdev/netdev_findbyname.c

@@ -53,7 +53,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_findbyname
+ * Name: netdev_findbyname
  *
  * Description:
  *   Find a previously registered network device using its assigned

net/netdev/netdev_foreach.c

@@ -51,7 +51,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_foreach
+ * Name: netdev_foreach
  *
  * Description:
  *   Enumerate each registered network device.

net/netdev/netdev_register.c

@@ -103,7 +103,7 @@ struct net_driver_s *g_netdevices = NULL;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: find_devnum
+ * Name: find_devnum
  *
  * Description:
  *   Given a device name format string, find the next device number for the
@@ -156,7 +156,7 @@ static int find_devnum(FAR const char *devfmt)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_register
+ * Name: netdev_register
  *
  * Description:
  *   Register a network device driver and assign a name to it so that it can

net/netdev/netdev_rxnotify.c

@@ -55,7 +55,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_ipv4_rxnotify
+ * Name: netdev_ipv4_rxnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv4 address that the
@@ -100,7 +100,7 @@ void netdev_ipv4_rxnotify(in_addr_t ripaddr)
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: netdev_ipv6_rxnotify
+ * Name: netdev_ipv6_rxnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv6 address that the

net/netdev/netdev_txnotify.c

@@ -55,7 +55,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_ipv4_txnotify
+ * Name: netdev_ipv4_txnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv4 address that new TX
@@ -101,7 +101,7 @@ void netdev_ipv4_txnotify(in_addr_t ripaddr)
 
 
 /****************************************************************************
- * Function: netdev_ipv6_txnotify
+ * Name: netdev_ipv6_txnotify
  *
  * Description:
  *   Notify the device driver that forwards the IPv4 address that new TX
@@ -147,7 +147,7 @@ void netdev_ipv6_txnotify(FAR const net_ipv6addr_t ripaddr)
 #endif /* CONFIG_NET_IPv6 */
 
 /****************************************************************************
- * Function: netdev_txnotify_dev
+ * Name: netdev_txnotify_dev
  *
  * Description:
  *   Notify the device driver that new TX data is available.  This variant

net/netdev/netdev_unregister.c

@@ -70,7 +70,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_unregister
+ * Name: netdev_unregister
  *
  * Description:
  *   Unregister a network device driver.

net/netdev/netdev_verify.c

@@ -51,7 +51,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_verify
+ * Name: netdev_verify
  *
  * Description:
  *   Verify that the specified device still exists

net/pkt/pkt.h

@@ -160,7 +160,7 @@ struct pkt_conn_s *pkt_nextconn(FAR struct pkt_conn_s *conn);
 
 /* Defined in pkt_callback.c ************************************************/
 /****************************************************************************
- * Function: pkt_callback
+ * Name: pkt_callback
  *
  * Description:
  *   Inform the application holding the packet socket of a change in state.
@@ -199,7 +199,7 @@ uint16_t pkt_callback(FAR struct net_driver_s *dev,
 /* pkt_input() is prototyped in include/nuttx/net/pkt.h */
 
 /****************************************************************************
- * Function: pkt_find_device
+ * Name: pkt_find_device
  *
  * Description:
  *   Select the network driver to use with the PKT transaction.
@@ -235,7 +235,7 @@ FAR struct net_driver_s *pkt_find_device(FAR struct pkt_conn_s *conn);
 void pkt_poll(FAR struct net_driver_s *dev, FAR struct pkt_conn_s *conn);
 
 /****************************************************************************
- * Function: psock_pkt_send
+ * Name: psock_pkt_send
  *
  * Description:
  *   The psock_pkt_send() call may be used only when the packet socket is in a

net/pkt/pkt_callback.c

@@ -54,7 +54,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: pkt_callback
+ * Name: pkt_callback
  *
  * Description:
  *   Inform the application holding the packet socket of a change in state.

net/pkt/pkt_finddev.c

@@ -50,7 +50,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: pkt_find_device
+ * Name: pkt_find_device
  *
  * Description:
  *   Select the network driver to use with the PKT transaction.

net/pkt/pkt_send.c

@@ -86,7 +86,7 @@ struct send_s
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_send_interrupt
+ * Name: psock_send_interrupt
  ****************************************************************************/
 
 static uint16_t psock_send_interrupt(FAR struct net_driver_s *dev,
@@ -152,7 +152,7 @@ static uint16_t psock_send_interrupt(FAR struct net_driver_s *dev,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_pkt_send
+ * Name: psock_pkt_send
  *
  * Description:
  *   The psock_pkt_send() call may be used only when the packet socket is in a

net/route/net_addroute.c

@@ -58,7 +58,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_addroute
+ * Name: net_addroute
  *
  * Description:
  *   Add a new route to the routing table

net/route/net_allocroute.c

@@ -93,7 +93,7 @@ static struct net_route_ipv6_s g_preallocroutes_ipv6[CONFIG_NET_MAXROUTES];
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_initroute
+ * Name: net_initroute
  *
  * Description:
  *   Initialize to the routing table
@@ -143,7 +143,7 @@ void net_initroute(void)
 }
 
 /****************************************************************************
- * Function: net_allocroute
+ * Name: net_allocroute
  *
  * Description:
  *   Allocate one route by removing it from the free list
@@ -196,7 +196,7 @@ FAR struct net_route_ipv6_s *net_allocroute_ipv6(void)
 #endif
 
 /****************************************************************************
- * Function: net_freeroute
+ * Name: net_freeroute
  *
  * Description:
  *   Free one route by adding it from the free list

net/route/net_delroute.c

@@ -76,7 +76,7 @@ struct route_match_ipv6_s
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_match
+ * Name: net_match
  *
  * Description:
  *   Return 1 if the route is available
@@ -175,7 +175,7 @@ static int net_match_ipv6(FAR struct net_route_ipv6_s *route, FAR void *arg)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_delroute
+ * Name: net_delroute
  *
  * Description:
  *   Remove an existing route from the routing table

net/route/net_foreachroute.c

@@ -55,7 +55,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_foreachroute
+ * Name: net_foreachroute
  *
  * Description:
  *   Traverse the route table

net/route/net_router.c

@@ -77,7 +77,7 @@ struct route_ipv6_match_s
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_ipv4_match
+ * Name: net_ipv4_match
  *
  * Description:
  *   Return 1 if the IPv4 route is available
@@ -114,7 +114,7 @@ static int net_ipv4_match(FAR struct net_route_s *route, FAR void *arg)
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: net_ipv6_match
+ * Name: net_ipv6_match
  *
  * Description:
  *   Return 1 if the IPv6 route is available
@@ -155,7 +155,7 @@ static int net_ipv6_match(FAR struct net_route_ipv6_s *route, FAR void *arg)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_ipv4_router
+ * Name: net_ipv4_router
  *
  * Description:
  *   Given an IPv4 address on a external network, return the address of the
@@ -213,7 +213,7 @@ int net_ipv4_router(in_addr_t target, FAR in_addr_t *router)
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: net_ipv6_router
+ * Name: net_ipv6_router
  *
  * Description:
  *   Given an IPv6 address on a external network, return the address of the

net/route/netdev_router.c

@@ -78,7 +78,7 @@ struct route_ipv6_devmatch_s
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_ipv4_devmatch
+ * Name: net_ipv4_devmatch
  *
  * Description:
  *   Return 1 if the IPv4 route is available on the device's network.
@@ -119,7 +119,7 @@ static int net_ipv4_devmatch(FAR struct net_route_s *route, FAR void *arg)
 #endif /* CONFIG_NET_IPv4 */
 
 /****************************************************************************
- * Function: net_ipv6_devmatch
+ * Name: net_ipv6_devmatch
  *
  * Description:
  *   Return 1 if the IPv6 route is available on the device's network.
@@ -164,7 +164,7 @@ static int net_ipv6_devmatch(FAR struct net_route_ipv6_s *route, FAR void *arg)
  ****************************************************************************/
 
 /****************************************************************************
- * Function: netdev_ipv4_router
+ * Name: netdev_ipv4_router
  *
  * Description:
  *   Given an IPv4 address on a external network, return the address of the
@@ -220,7 +220,7 @@ void netdev_ipv4_router(FAR struct net_driver_s *dev, in_addr_t target,
 #endif
 
 /****************************************************************************
- * Function: netdev_ipv6_router
+ * Name: netdev_ipv6_router
  *
  * Description:
  *   Given an IPv6 address on a external network, return the address of the

net/route/route.h

@@ -118,7 +118,7 @@ EXTERN sq_queue_t g_routes_ipv6;
  ****************************************************************************/
 
 /****************************************************************************
- * Function: net_initroute
+ * Name: net_initroute
  *
  * Description:
  *   Initialize to the routing table
@@ -134,7 +134,7 @@ EXTERN sq_queue_t g_routes_ipv6;
 void net_initroute(void);
 
 /****************************************************************************
- * Function: net_allocroute
+ * Name: net_allocroute
  *
  * Description:
  *   Allocate one route by removing it from the free list
@@ -157,7 +157,7 @@ FAR struct net_route_ipv6_s *net_allocroute_ipv6(void);
 #endif
 
 /****************************************************************************
- * Function: net_allocroute
+ * Name: net_allocroute
  *
  * Description:
  *   Free one route by adding it from the free list
@@ -179,7 +179,7 @@ void net_freeroute_ipv6(FAR struct net_route_ipv6_s *route);
 #endif
 
 /****************************************************************************
- * Function: net_addroute
+ * Name: net_addroute
  *
  * Description:
  *   Add a new route to the routing table
@@ -206,7 +206,7 @@ int net_addroute_ipv6(net_ipv6addr_t target, net_ipv6addr_t netmask,
 #endif
 
 /****************************************************************************
- * Function: net_delroute
+ * Name: net_delroute
  *
  * Description:
  *   Remove an existing route from the routing table
@@ -227,7 +227,7 @@ int net_delroute_ipv6(net_ipv6addr_t target, net_ipv6addr_t netmask);
 #endif
 
 /****************************************************************************
- * Function: net_ipv4_router
+ * Name: net_ipv4_router
  *
  * Description:
  *   Given an IPv4 address on a external network, return the address of the
@@ -248,7 +248,7 @@ int net_ipv4_router(in_addr_t target, FAR in_addr_t *router);
 #endif
 
 /****************************************************************************
- * Function: net_ipv6_router
+ * Name: net_ipv6_router
  *
  * Description:
  *   Given an IPv6 address on a external network, return the address of the
@@ -269,7 +269,7 @@ int net_ipv6_router(net_ipv6addr_t target, net_ipv6addr_t router);
 #endif
 
 /****************************************************************************
- * Function: netdev_ipv4_router
+ * Name: netdev_ipv4_router
  *
  * Description:
  *   Given an IPv4 address on a external network, return the address of the
@@ -296,7 +296,7 @@ void netdev_ipv4_router(FAR struct net_driver_s *dev, in_addr_t target,
 #endif
 
 /****************************************************************************
- * Function: netdev_ipv6_router
+ * Name: netdev_ipv6_router
  *
  * Description:
  *   Given an IPv6 address on a external network, return the address of the
@@ -324,7 +324,7 @@ void netdev_ipv6_router(FAR struct net_driver_s *dev,
 #endif
 
 /****************************************************************************
- * Function: net_foreachroute
+ * Name: net_foreachroute
  *
  * Description:
  *   Traverse the route table

net/socket/accept.c

@@ -61,7 +61,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_accept
+ * Name: psock_accept
  *
  * Description:
  *   The psock_accept function is used with connection-based socket types
@@ -305,7 +305,7 @@ errout:
 }
 
 /****************************************************************************
- * Function: accept
+ * Name: accept
  *
  * Description:
  *   The accept function is used with connection-based socket types

net/socket/bind.c

@@ -68,7 +68,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: pkt_bind
+ * Name: pkt_bind
  *
  * Description:
  *   Bind a raw socket to an network device.
@@ -122,7 +122,7 @@ static int pkt_bind(FAR struct pkt_conn_s *conn,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_bind
+ * Name: psock_bind
  *
  * Description:
  *   bind() gives the socket 'psock' the local address 'addr'. 'addr' is
@@ -345,7 +345,7 @@ errout:
 }
 
 /****************************************************************************
- * Function: bind
+ * Name: bind
  *
  * Description:
  *   bind() gives the socket 'sockfd' the local address 'addr'. 'addr' is

net/socket/getsockname.c

@@ -64,7 +64,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: get_ipv4_sockname
+ * Name: get_ipv4_sockname
  *
  * Description:
  *   The getsockname() function retrieves the locally-bound name of the
@@ -187,7 +187,7 @@ int ipv4_getsockname(FAR struct socket *psock, FAR struct sockaddr *addr,
 #endif
 
 /****************************************************************************
- * Function: ipv6_getsockname
+ * Name: ipv6_getsockname
  *
  * Description:
  *   The getsockname() function retrieves the locally-bound name of the
@@ -314,7 +314,7 @@ int ipv6_getsockname(FAR struct socket *psock, FAR struct sockaddr *addr,
  ****************************************************************************/
 
 /****************************************************************************
- * Function: getsockname
+ * Name: getsockname
  *
  * Description:
  *   The getsockname() function retrieves the locally-bound name of the

net/socket/getsockopt.c

@@ -56,7 +56,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_getsockopt
+ * Name: psock_getsockopt
  *
  * Description:
  *   getsockopt() retrieve thse value for the option specified by the
@@ -277,7 +277,7 @@ errout:
 }
 
 /****************************************************************************
- * Function: getsockopt
+ * Name: getsockopt
  *
  * Description:
  *   getsockopt() retrieve thse value for the option specified by the

net/socket/listen.c

@@ -55,7 +55,7 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function: psock_listen
+ * Name: psock_listen
  *
  * Description:
  *   To accept connections, a socket is first created with psock_socket(), a
@@ -168,7 +168,7 @@ errout:
 }
 
 /****************************************************************************
- * Function: listen
+ * Name: listen
  *
  * Description:
  *   To accept connections, a socket is first created with socket(), a