diff --git a/lib/libc/net/if_indextoname.3 b/lib/libc/net/if_indextoname.3 index c6c1a0e887d0..14ed3d0e916b 100644 --- a/lib/libc/net/if_indextoname.3 +++ b/lib/libc/net/if_indextoname.3 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)rcmd.3 8.1 (Berkeley) 6/4/93 -.\" $Id: if_indextoname.3,v 1.2 1999/07/03 13:58:31 kleink Exp $ +.\" KAME Id: if_indextoname.3,v 1.4 1999/12/10 04:07:00 itojun Exp .\" .Dd May 21, 1998 .Dt IF_NAMETOINDEX 3 @@ -57,17 +57,23 @@ The functions map interface index to readable interface name .Po such as -.Li ``lo0'' +.Dq Li lo0 .Pc , and vice versa. .Pp +The .Fn if_nametoindex -converts readable interface name to interface index -.Pp positive integer value . +function +converts an interface name specified by the +.Fa ifname +argument to an interface index +.Pq positive integer value . If the specified interface does not exist, 0 will be returned. .Pp .Fn if_indextoname -converts interface index to readable interface name. +converts an interface index specified by the +.Fa ifindex +argument to an interface name. The .Fa ifname argument must point to a buffer of at least @@ -77,7 +83,7 @@ returned. .Po .Dv IF_NAMESIZE is also defined in -.Li +.Aq Li net/if.h and its value includes a terminating null byte at the end of the interface name. .Pc @@ -92,7 +98,7 @@ returns an array of structures. .Fa if_nametoindex is also defined in -.Li , +.Aq Li net/if.h , and is as follows: .Bd -literal -offset struct if_nameindex { @@ -135,10 +141,18 @@ return .Dv NULL on errors. .Sh SEE ALSO -R. Gilligan, S. Thomson, J. Bound, and W. Stevens, -``Basic Socket Interface Extensions for IPv6,'' RFC2553, March 1999. +.Rs +.%A R. Gilligan +.%A S. Thomson +.%A J. Bound +.%A W. Stevens +.%T Basic Socket Interface Extensions for IPv6 +.%R RFC2553 +.%D March 1999 +.Re .Sh HISTORY The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit. .Sh STANDARDS -These functions are defined in ``Basic Socket Interface Extensions for IPv6'' +These functions are defined in +.Dq Basic Socket Interface Extensions for IPv6 .Pq RFC2533 .