.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\"     libc.info (from glibc distribution)
.\" Modified Sat Jul 24 19:12:00 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Sun Sep  3 20:29:36 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
.\" Changed network into host byte order (for inet_network),
.\"     Andreas Jaeger <aj@arthur.rhein-neckar.de>, 980130.
.\"
.\" Translated into Spanish Thu Mar 26 14:02:26 CET 1998 by
.\" 	Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es>
.\" Translation revised Mon Aug 17 1998 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Sun Apr  4 1999 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH INET 3  "3 Septiembre  1995" "BSD" "Manual del Programador de Linux"
.SH NOMBRE
inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, 
inet_netof \- Rutinas de manipulación de direcciones de Internet
.SH SINOPSIS
.nf
.B #include <sys/socket.h>
.B #include <netinet/in.h>
.B #include <arpa/inet.h>
.sp
.BI "int inet_aton(const char *" cp ", struct in_addr *" inp ");"
.sp
.BI "unsigned long int inet_addr(const char *" cp );
.sp
.BI "unsigned long int inet_network(const char *" cp );
.sp
.BI "char *inet_ntoa(struct in_addr " in );
.sp
.BI "struct in_addr inet_makeaddr(int " net ", int " host );
.sp
.BI "unsigned long int inet_lnaof(struct in_addr " in );
.sp
.BI "unsigned long int inet_netof(struct in_addr " in );
.fi
.SH DESCRIPCIÓN
\fBinet_aton()\fP convierte la dirección de Internet \fIcp\fP desde la
notación estándar de números y puntos a la representación binaria, y
la guarda en la estructura a la que apunte \fIinp\fP. \fBinet_aton\fP devuelve
no-cero si la dirección es válida, cero si no.
.PP
La función \fBinet_addr()\fP convierte la dirección de Internet
\fIcp\fP desde la notación de números y puntos a la de datos binarios
en orden de bytes del ordenador local. Si la entrada no es válida, devuelve
INADDR_NONE (usualmente \-1). Ésta es una interfaz \fIobsoleta\fP
a \fBinet_aton\fP, descrita anteriormente; es obsoleta porque \-1 es una
dirección válida (255.255.255.255), e \fBinet_aton\fP porporciona una manera
más clara para indicar que ha ocurrido un error.
.PP
La función \fBinet_network()\fP extrae el número de red en orden de
bytes de red desde la dirección \fIcp\fP a la notación de números y
puntos. Si la entrada es inválida, devuelve \-1.
.PP
La función \fBinet_ntoa()\fP convierte la dirección de Internet
\fIin\fP dada en orden de bytes de red a una cadena de caracteres en
la notación estándar de números y puntos. La cadena se devuelve en un
búfer reservado estáticamente, que será sobreescrito en siguientes llamadas.
.PP
La función \fBinet_makeaddr()\fP construye una dirección de Internet
en orden de bytes de red combinando el número de red \fInet\fP
con la dirección local \fIhost\fP en la red \fInet\fP, ambas en orden
de bytes de ordenador local.
.PP
La función \fBinet_lnaof()\fP devuelve la parte del ordenador local de
la dirección de  Internet \fIin\fP.  La dirección de ordenador local
se devuelve en orden de bytes de ordenador local.
.PP
La función \fBinet_netof()\fP devuelve la parte de número de red de la
dirección de Internet \fIin\fP.  El número de red se devuelve en orden
de bytes de ordenador local.
.PP
La estructura \fIin_addr\fP, empleada en \fBinet_ntoa()\fP,
\fBinet_makeaddr()\fP, \fBinet_lnoaf()\fP e \fBinet_netof()\fP
se define en \fInetinet/in.h\fP como:
.sp
.RS
.nf
.ne 7
.ta 8n 16n
struct in_addr {
	unsigned long int s_addr;
}
.ta
.fi
.RE
.PP
Observe que en el i80x86 el orden de bytes de ordenador es: primero el
Byte Menos Significativo (LSB), mientras que el orden de bytes de red
es, como se usa en la Internet, el Byte Más Significativo (MSB) primero.
.SH "CONFORME A"
BSD 4.3
.SH "VÉASE TAMBIÉN"
.BR gethostbyname "(3), " getnetent "(3), " hosts "(5), " networks (5)