[p5sagit/p5-mst-13.2.git] / ext / Socket / Socket.pm

package Socket;

our($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS);
$VERSION = "1.75";

=head1 NAME

Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C socket.h defines and structure manipulators 

=head1 SYNOPSIS

    use Socket;

    $proto = getprotobyname('udp');
    socket(Socket_Handle, PF_INET, SOCK_DGRAM, $proto);
    $iaddr = gethostbyname('hishost.com');
    $port = getservbyname('time', 'udp');
    $sin = sockaddr_in($port, $iaddr);
    send(Socket_Handle, 0, 0, $sin);

    $proto = getprotobyname('tcp');
    socket(Socket_Handle, PF_INET, SOCK_STREAM, $proto);
    $port = getservbyname('smtp', 'tcp');
    $sin = sockaddr_in($port,inet_aton("127.1"));
    $sin = sockaddr_in(7,inet_aton("localhost"));
    $sin = sockaddr_in(7,INADDR_LOOPBACK);
    connect(Socket_Handle,$sin);

    ($port, $iaddr) = sockaddr_in(getpeername(Socket_Handle));
    $peer_host = gethostbyaddr($iaddr, AF_INET);
    $peer_addr = inet_ntoa($iaddr);

    $proto = getprotobyname('tcp');
    socket(Socket_Handle, PF_UNIX, SOCK_STREAM, $proto);
    unlink('/tmp/usock');
    $sun = sockaddr_un('/tmp/usock');
    connect(Socket_Handle,$sun);

=head1 DESCRIPTION

This module is just a translation of the C F<socket.h> file.
Unlike the old mechanism of requiring a translated F<socket.ph>
file, this uses the B<h2xs> program (see the Perl source distribution)
and your native C compiler.  This means that it has a 
far more likely chance of getting the numbers right.  This includes
all of the commonly used pound-defines like AF_INET, SOCK_STREAM, etc.

Also, some common socket "newline" constants are provided: the
constants C<CR>, C<LF>, and C<CRLF>, as well as C<$CR>, C<$LF>, and
C<$CRLF>, which map to C<\015>, C<\012>, and C<\015\012>.  If you do
not want to use the literal characters in your programs, then use
the constants provided here.  They are not exported by default, but can
be imported individually, and with the C<:crlf> export tag:

    use Socket qw(:DEFAULT :crlf);

In addition, some structure manipulation functions are available:

=over 4

=item inet_aton HOSTNAME

Takes a string giving the name of a host, and translates that to an
opaque string (if programming in C, struct in_addr). Takes arguments
of both the 'rtfm.mit.edu' type and '18.181.0.24'. If the host name
cannot be resolved, returns undef.  For multi-homed hosts (hosts with
more than one address), the first address found is returned.

For portability do not assume that the result of inet_aton() is 32
bits wide, in other words, that it would contain only the IPv4 address
in network order.

=item inet_ntoa IP_ADDRESS

Takes a string (an opaque string as returned by inet_aton(),
or a v-string representing the four octets of the IPv4 address in
network order) and translates it into a string of the form 'd.d.d.d'
where the 'd's are numbers less than 256 (the normal human-readable
four dotted number notation for Internet addresses).

=item INADDR_ANY

Note: does not return a number, but a packed string.

Returns the 4-byte wildcard ip address which specifies any
of the hosts ip addresses.  (A particular machine can have
more than one ip address, each address corresponding to
a particular network interface. This wildcard address
allows you to bind to all of them simultaneously.)
Normally equivalent to inet_aton('0.0.0.0').

=item INADDR_BROADCAST

Note: does not return a number, but a packed string.

Returns the 4-byte 'this-lan' ip broadcast address.
This can be useful for some protocols to solicit information
from all servers on the same LAN cable.
Normally equivalent to inet_aton('255.255.255.255').

=item INADDR_LOOPBACK

Note - does not return a number.

Returns the 4-byte loopback address.  Normally equivalent
to inet_aton('localhost').

=item INADDR_NONE

Note - does not return a number.

Returns the 4-byte 'invalid' ip address.  Normally equivalent
to inet_aton('255.255.255.255').

=item sockaddr_in PORT, ADDRESS

=item sockaddr_in SOCKADDR_IN

In a list context, unpacks its SOCKADDR_IN argument and returns an array
consisting of (PORT, ADDRESS).  In a scalar context, packs its (PORT,
ADDRESS) arguments as a SOCKADDR_IN and returns it.  If this is confusing,
use pack_sockaddr_in() and unpack_sockaddr_in() explicitly.

=item pack_sockaddr_in PORT, IP_ADDRESS

Takes two arguments, a port number and an opaque string, IP_ADDRESS
(as returned by inet_aton(), or a v-string).  Returns the sockaddr_in
structure with those arguments packed in with AF_INET filled in.  For
Internet domain sockets, this structure is normally what you need for
the arguments in bind(), connect(), and send(), and is also returned
by getpeername(), getsockname() and recv().

=item unpack_sockaddr_in SOCKADDR_IN

Takes a sockaddr_in structure (as returned by pack_sockaddr_in()) and
returns an array of two elements: the port and an opaque string
representing the IP address (you can use inet_ntoa() to convert the
address to the four-dotted numeric format).  Will croak if the
structure does not have AF_INET in the right place.

=item sockaddr_un PATHNAME

=item sockaddr_un SOCKADDR_UN

In a list context, unpacks its SOCKADDR_UN argument and returns an array
consisting of (PATHNAME).  In a scalar context, packs its PATHNAME
arguments as a SOCKADDR_UN and returns it.  If this is confusing, use
pack_sockaddr_un() and unpack_sockaddr_un() explicitly.
These are only supported if your system has E<lt>F<sys/un.h>E<gt>.

=item pack_sockaddr_un PATH

Takes one argument, a pathname. Returns the sockaddr_un structure with
that path packed in with AF_UNIX filled in. For unix domain sockets, this
structure is normally what you need for the arguments in bind(),
connect(), and send(), and is also returned by getpeername(),
getsockname() and recv().

=item unpack_sockaddr_un SOCKADDR_UN

Takes a sockaddr_un structure (as returned by pack_sockaddr_un())
and returns the pathname.  Will croak if the structure does not
have AF_UNIX in the right place.

=back

=cut

use Carp;
use warnings::register;

require Exporter;
use XSLoader ();
@ISA = qw(Exporter);
@EXPORT = qw(
	inet_aton inet_ntoa pack_sockaddr_in unpack_sockaddr_in
	pack_sockaddr_un unpack_sockaddr_un
	sockaddr_in sockaddr_un
	INADDR_ANY INADDR_BROADCAST INADDR_LOOPBACK INADDR_NONE
	AF_802
	AF_APPLETALK
	AF_CCITT
	AF_CHAOS
	AF_DATAKIT
	AF_DECnet
	AF_DLI
	AF_ECMA
	AF_GOSIP
	AF_HYLINK
	AF_IMPLINK
	AF_INET
	AF_LAT
	AF_MAX
	AF_NBS
	AF_NIT
	AF_NS
	AF_OSI
	AF_OSINET
	AF_PUP
	AF_SNA
	AF_UNIX
	AF_UNSPEC
	AF_X25
	IOV_MAX
	MSG_BCAST
	MSG_CTLFLAGS
	MSG_CTLIGNORE
	MSG_CTRUNC
	MSG_DONTROUTE
	MSG_DONTWAIT
	MSG_EOF
	MSG_EOR
	MSG_ERRQUEUE
	MSG_FIN
	MSG_MAXIOVLEN
	MSG_MCAST
	MSG_NOSIGNAL
	MSG_OOB
	MSG_PEEK
	MSG_PROXY
	MSG_RST
	MSG_SYN
	MSG_TRUNC
	MSG_URG
	MSG_WAITALL
	PF_802
	PF_APPLETALK
	PF_CCITT
	PF_CHAOS
	PF_DATAKIT
	PF_DECnet
	PF_DLI
	PF_ECMA
	PF_GOSIP
	PF_HYLINK
	PF_IMPLINK
	PF_INET
	PF_LAT
	PF_MAX
	PF_NBS
	PF_NIT
	PF_NS
	PF_OSI
	PF_OSINET
	PF_PUP
	PF_SNA
	PF_UNIX
	PF_UNSPEC
	PF_X25
	SCM_CONNECT
	SCM_CREDENTIALS
	SCM_CREDS
	SCM_RIGHTS
	SCM_TIMESTAMP
	SHUT_RD
	SHUT_RDWR
	SHUT_WR
	SOCK_DGRAM
	SOCK_RAW
	SOCK_RDM
	SOCK_SEQPACKET
	SOCK_STREAM
	SOL_SOCKET
	SOMAXCONN
	SO_ACCEPTCONN
	SO_BROADCAST
	SO_DEBUG
	SO_DONTLINGER
	SO_DONTROUTE
	SO_ERROR
	SO_KEEPALIVE
	SO_LINGER
	SO_OOBINLINE
	SO_RCVBUF
	SO_RCVLOWAT
	SO_RCVTIMEO
	SO_REUSEADDR
	SO_REUSEPORT
	SO_SNDBUF
	SO_SNDLOWAT
	SO_SNDTIMEO
	SO_TYPE
	SO_USELOOPBACK
	UIO_MAXIOV
);

@EXPORT_OK = qw(CR LF CRLF $CR $LF $CRLF

	       IPPROTO_TCP
	       TCP_KEEPALIVE
	       TCP_MAXRT
	       TCP_MAXSEG
	       TCP_NODELAY
	       TCP_STDURG);

%EXPORT_TAGS = (
    crlf    => [qw(CR LF CRLF $CR $LF $CRLF)],
    all     => [@EXPORT, @EXPORT_OK],
);

BEGIN {
    sub CR   () {"\015"}
    sub LF   () {"\012"}
    sub CRLF () {"\015\012"}
}

*CR   = \CR();
*LF   = \LF();
*CRLF = \CRLF();

sub sockaddr_in {
    if (@_ == 6 && !wantarray) { # perl5.001m compat; use this && die
	my($af, $port, @quad) = @_;
	warnings::warn "6-ARG sockaddr_in call is deprecated" 
	    if warnings::enabled();
	pack_sockaddr_in($port, inet_aton(join('.', @quad)));
    } elsif (wantarray) {
	croak "usage:   (port,iaddr) = sockaddr_in(sin_sv)" unless @_ == 1;
        unpack_sockaddr_in(@_);
    } else {
	croak "usage:   sin_sv = sockaddr_in(port,iaddr))" unless @_ == 2;
        pack_sockaddr_in(@_);
    }
}

sub sockaddr_un {
    if (wantarray) {
	croak "usage:   (filename) = sockaddr_un(sun_sv)" unless @_ == 1;
        unpack_sockaddr_un(@_);
    } else {
	croak "usage:   sun_sv = sockaddr_un(filename)" unless @_ == 1;
        pack_sockaddr_un(@_);
    }
}

sub AUTOLOAD {
    my($constname);
    ($constname = $AUTOLOAD) =~ s/.*:://;
    croak "&Socket::constant not defined" if $constname eq 'constant';
    my ($error, $val) = constant($constname);
    if ($error) {
	croak $error;
    }
    *$AUTOLOAD = sub { $val };
    goto &$AUTOLOAD;
}

XSLoader::load 'Socket', $VERSION;

1;
Commit	Line	Data
a0d0e21e	1	package Socket;
73c78b0a	2
17f410f9	3	our($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS);
6fe628c6	4	$VERSION = "1.75";
3b35bae3	5
	6	=head1 NAME
	7
cb1a09d0	8	Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C socket.h defines and structure manipulators
3b35bae3	9
	10	=head1 SYNOPSIS
	11
	12	use Socket;
	13
4633a7c4	14	$proto = getprotobyname('udp');
8e07c86e	15	socket(Socket_Handle, PF_INET, SOCK_DGRAM, $proto);
4633a7c4	16	$iaddr = gethostbyname('hishost.com');
	17	$port = getservbyname('time', 'udp');
	18	$sin = sockaddr_in($port, $iaddr);
	19	send(Socket_Handle, 0, 0, $sin);
	20
	21	$proto = getprotobyname('tcp');
	22	socket(Socket_Handle, PF_INET, SOCK_STREAM, $proto);
67d7c167	23	$port = getservbyname('smtp', 'tcp');
4633a7c4	24	$sin = sockaddr_in($port,inet_aton("127.1"));
	25	$sin = sockaddr_in(7,inet_aton("localhost"));
	26	$sin = sockaddr_in(7,INADDR_LOOPBACK);
	27	connect(Socket_Handle,$sin);
	28
	29	($port, $iaddr) = sockaddr_in(getpeername(Socket_Handle));
	30	$peer_host = gethostbyaddr($iaddr, AF_INET);
	31	$peer_addr = inet_ntoa($iaddr);
	32
	33	$proto = getprotobyname('tcp');
	34	socket(Socket_Handle, PF_UNIX, SOCK_STREAM, $proto);
	35	unlink('/tmp/usock');
	36	$sun = sockaddr_un('/tmp/usock');
	37	connect(Socket_Handle,$sun);
3b35bae3	38
	39	=head1 DESCRIPTION
	40
	41	This module is just a translation of the C F<socket.h> file.
	42	Unlike the old mechanism of requiring a translated F<socket.ph>
	43	file, this uses the B<h2xs> program (see the Perl source distribution)
	44	and your native C compiler. This means that it has a
4633a7c4	45	far more likely chance of getting the numbers right. This includes
4633a7c4	46	all of the commonly used pound-defines like AF_INET, SOCK_STREAM, etc.
3b35bae3	47
fdb41d65	48	Also, some common socket "newline" constants are provided: the
	49	constants C<CR>, C<LF>, and C<CRLF>, as well as C<$CR>, C<$LF>, and
	50	C<$CRLF>, which map to C<\015>, C<\012>, and C<\015\012>. If you do
	51	not want to use the literal characters in your programs, then use
	52	the constants provided here. They are not exported by default, but can
	53	be imported individually, and with the C<:crlf> export tag:
	54
	55	use Socket qw(:DEFAULT :crlf);
	56
8e07c86e	57	In addition, some structure manipulation functions are available:
8e07c86e	58
bbc7dcd2	59	=over 4
2ae324a7	60
8e07c86e	61	=item inet_aton HOSTNAME
8e07c86e	62
6fe628c6	63	Takes a string giving the name of a host, and translates that to an
	64	opaque string (if programming in C, struct in_addr). Takes arguments
	65	of both the 'rtfm.mit.edu' type and '18.181.0.24'. If the host name
	66	cannot be resolved, returns undef. For multi-homed hosts (hosts with
	67	more than one address), the first address found is returned.
8e07c86e	68
2528d3bc	69	For portability do not assume that the result of inet_aton() is 32
6fe628c6	70	bits wide, in other words, that it would contain only the IPv4 address
6fe628c6	71	in network order.
2528d3bc	72
8e07c86e	73	=item inet_ntoa IP_ADDRESS
8e07c86e	74
6fe628c6	75	Takes a string (an opaque string as returned by inet_aton(),
6fe628c6	76	or a v-string representing the four octets of the IPv4 address in
2528d3bc	77	network order) and translates it into a string of the form 'd.d.d.d'
6fe628c6	78	where the 'd's are numbers less than 256 (the normal human-readable
6fe628c6	79	four dotted number notation for Internet addresses).
8e07c86e	80
	81	=item INADDR_ANY
	82
4633a7c4	83	Note: does not return a number, but a packed string.
8e07c86e	84
8e07c86e	85	Returns the 4-byte wildcard ip address which specifies any
6fe628c6	86	of the hosts ip addresses. (A particular machine can have
8e07c86e	87	more than one ip address, each address corresponding to
	88	a particular network interface. This wildcard address
	89	allows you to bind to all of them simultaneously.)
	90	Normally equivalent to inet_aton('0.0.0.0').
	91
7e1af8bc	92	=item INADDR_BROADCAST
	93
	94	Note: does not return a number, but a packed string.
	95
	96	Returns the 4-byte 'this-lan' ip broadcast address.
	97	This can be useful for some protocols to solicit information
	98	from all servers on the same LAN cable.
	99	Normally equivalent to inet_aton('255.255.255.255').
	100
8e07c86e	101	=item INADDR_LOOPBACK
	102
	103	Note - does not return a number.
	104
6fe628c6	105	Returns the 4-byte loopback address. Normally equivalent
8e07c86e	106	to inet_aton('localhost').
3b35bae3	107
8e07c86e	108	=item INADDR_NONE
	109
	110	Note - does not return a number.
	111
6fe628c6	112	Returns the 4-byte 'invalid' ip address. Normally equivalent
8e07c86e	113	to inet_aton('255.255.255.255').
8e07c86e	114
4633a7c4	115	=item sockaddr_in PORT, ADDRESS
	116
	117	=item sockaddr_in SOCKADDR_IN
	118
91e74348	119	In a list context, unpacks its SOCKADDR_IN argument and returns an array
4633a7c4	120	consisting of (PORT, ADDRESS). In a scalar context, packs its (PORT,
	121	ADDRESS) arguments as a SOCKADDR_IN and returns it. If this is confusing,
	122	use pack_sockaddr_in() and unpack_sockaddr_in() explicitly.
	123
	124	=item pack_sockaddr_in PORT, IP_ADDRESS
8e07c86e	125
6fe628c6	126	Takes two arguments, a port number and an opaque string, IP_ADDRESS
	127	(as returned by inet_aton(), or a v-string). Returns the sockaddr_in
	128	structure with those arguments packed in with AF_INET filled in. For
	129	Internet domain sockets, this structure is normally what you need for
	130	the arguments in bind(), connect(), and send(), and is also returned
	131	by getpeername(), getsockname() and recv().
8e07c86e	132
	133	=item unpack_sockaddr_in SOCKADDR_IN
	134
4633a7c4	135	Takes a sockaddr_in structure (as returned by pack_sockaddr_in()) and
6fe628c6	136	returns an array of two elements: the port and an opaque string
	137	representing the IP address (you can use inet_ntoa() to convert the
	138	address to the four-dotted numeric format). Will croak if the
	139	structure does not have AF_INET in the right place.
4633a7c4	140
	141	=item sockaddr_un PATHNAME
	142
	143	=item sockaddr_un SOCKADDR_UN
	144
91e74348	145	In a list context, unpacks its SOCKADDR_UN argument and returns an array
1fef88e7	146	consisting of (PATHNAME). In a scalar context, packs its PATHNAME
4633a7c4	147	arguments as a SOCKADDR_UN and returns it. If this is confusing, use
4633a7c4	148	pack_sockaddr_un() and unpack_sockaddr_un() explicitly.
1fef88e7	149	These are only supported if your system has E<lt>F<sys/un.h>E<gt>.
4633a7c4	150
	151	=item pack_sockaddr_un PATH
	152
	153	Takes one argument, a pathname. Returns the sockaddr_un structure with
	154	that path packed in with AF_UNIX filled in. For unix domain sockets, this
	155	structure is normally what you need for the arguments in bind(),
	156	connect(), and send(), and is also returned by getpeername(),
	157	getsockname() and recv().
	158
	159	=item unpack_sockaddr_un SOCKADDR_UN
	160
	161	Takes a sockaddr_un structure (as returned by pack_sockaddr_un())
	162	and returns the pathname. Will croak if the structure does not
	163	have AF_UNIX in the right place.
3b35bae3	164
2ae324a7	165	=back
2ae324a7	166
3b35bae3	167	=cut
3b35bae3	168
a0d0e21e	169	use Carp;
d3a7d8c7	170	use warnings::register;
a0d0e21e	171
a0d0e21e	172	require Exporter;
9426adcd	173	use XSLoader ();
9426adcd	174	@ISA = qw(Exporter);
a0d0e21e	175	@EXPORT = qw(
8e07c86e	176	inet_aton inet_ntoa pack_sockaddr_in unpack_sockaddr_in
4633a7c4	177	pack_sockaddr_un unpack_sockaddr_un
4633a7c4	178	sockaddr_in sockaddr_un
7e1af8bc	179	INADDR_ANY INADDR_BROADCAST INADDR_LOOPBACK INADDR_NONE
a0d0e21e	180	AF_802
	181	AF_APPLETALK
	182	AF_CCITT
	183	AF_CHAOS
	184	AF_DATAKIT
	185	AF_DECnet
	186	AF_DLI
	187	AF_ECMA
	188	AF_GOSIP
	189	AF_HYLINK
	190	AF_IMPLINK
	191	AF_INET
	192	AF_LAT
	193	AF_MAX
	194	AF_NBS
	195	AF_NIT
	196	AF_NS
	197	AF_OSI
	198	AF_OSINET
	199	AF_PUP
	200	AF_SNA
	201	AF_UNIX
	202	AF_UNSPEC
	203	AF_X25
6b1016b5	204	IOV_MAX
6b1016b5	205	MSG_BCAST
de4597cb	206	MSG_CTLFLAGS
	207	MSG_CTLIGNORE
	208	MSG_CTRUNC
a0d0e21e	209	MSG_DONTROUTE
de4597cb	210	MSG_DONTWAIT
	211	MSG_EOF
	212	MSG_EOR
	213	MSG_ERRQUEUE
	214	MSG_FIN
a0d0e21e	215	MSG_MAXIOVLEN
6b1016b5	216	MSG_MCAST
de4597cb	217	MSG_NOSIGNAL
a0d0e21e	218	MSG_OOB
a0d0e21e	219	MSG_PEEK
de4597cb	220	MSG_PROXY
	221	MSG_RST
	222	MSG_SYN
	223	MSG_TRUNC
	224	MSG_URG
	225	MSG_WAITALL
a0d0e21e	226	PF_802
	227	PF_APPLETALK
	228	PF_CCITT
	229	PF_CHAOS
	230	PF_DATAKIT
	231	PF_DECnet
	232	PF_DLI
	233	PF_ECMA
	234	PF_GOSIP
	235	PF_HYLINK
	236	PF_IMPLINK
	237	PF_INET
	238	PF_LAT
	239	PF_MAX
	240	PF_NBS
	241	PF_NIT
	242	PF_NS
	243	PF_OSI
	244	PF_OSINET
	245	PF_PUP
	246	PF_SNA
	247	PF_UNIX
	248	PF_UNSPEC
	249	PF_X25
de4597cb	250	SCM_CONNECT
	251	SCM_CREDENTIALS
	252	SCM_CREDS
	253	SCM_RIGHTS
	254	SCM_TIMESTAMP
ca6e1c26	255	SHUT_RD
	256	SHUT_RDWR
	257	SHUT_WR
a0d0e21e	258	SOCK_DGRAM
	259	SOCK_RAW
	260	SOCK_RDM
	261	SOCK_SEQPACKET
	262	SOCK_STREAM
	263	SOL_SOCKET
	264	SOMAXCONN
	265	SO_ACCEPTCONN
	266	SO_BROADCAST
	267	SO_DEBUG
	268	SO_DONTLINGER
	269	SO_DONTROUTE
	270	SO_ERROR
	271	SO_KEEPALIVE
	272	SO_LINGER
	273	SO_OOBINLINE
	274	SO_RCVBUF
	275	SO_RCVLOWAT
	276	SO_RCVTIMEO
	277	SO_REUSEADDR
b2f54bf3	278	SO_REUSEPORT
a0d0e21e	279	SO_SNDBUF
	280	SO_SNDLOWAT
	281	SO_SNDTIMEO
	282	SO_TYPE
	283	SO_USELOOPBACK
6b1016b5	284	UIO_MAXIOV
a0d0e21e	285	);
a0d0e21e	286
1494e794	287	@EXPORT_OK = qw(CR LF CRLF $CR $LF $CRLF
	288
	289	IPPROTO_TCP
	290	TCP_KEEPALIVE
	291	TCP_MAXRT
	292	TCP_MAXSEG
	293	TCP_NODELAY
	294	TCP_STDURG);
fdb41d65	295
fdb41d65	296	%EXPORT_TAGS = (
dde527fc	297	crlf => [qw(CR LF CRLF $CR $LF $CRLF)],
fdb41d65	298	all => [@EXPORT, @EXPORT_OK],
	299	);
	300
	301	BEGIN {
	302	sub CR () {"\015"}
	303	sub LF () {"\012"}
	304	sub CRLF () {"\015\012"}
	305	}
	306
	307	*CR = \CR();
	308	*LF = \LF();
	309	*CRLF = \CRLF();
	310
4633a7c4	311	sub sockaddr_in {
	312	if (@_ == 6 && !wantarray) { # perl5.001m compat; use this && die
	313	my($af, $port, @quad) = @_;
d3a7d8c7	314	warnings::warn "6-ARG sockaddr_in call is deprecated"
d3a7d8c7	315	if warnings::enabled();
4633a7c4	316	pack_sockaddr_in($port, inet_aton(join('.', @quad)));
	317	} elsif (wantarray) {
	318	croak "usage: (port,iaddr) = sockaddr_in(sin_sv)" unless @_ == 1;
	319	unpack_sockaddr_in(@_);
	320	} else {
	321	croak "usage: sin_sv = sockaddr_in(port,iaddr))" unless @_ == 2;
	322	pack_sockaddr_in(@_);
	323	}
	324	}
	325
	326	sub sockaddr_un {
	327	if (wantarray) {
	328	croak "usage: (filename) = sockaddr_un(sun_sv)" unless @_ == 1;
	329	unpack_sockaddr_un(@_);
	330	} else {
37120919	331	croak "usage: sun_sv = sockaddr_un(filename)" unless @_ == 1;
37120919	332	pack_sockaddr_un(@_);
4633a7c4	333	}
	334	}
	335
a0d0e21e	336	sub AUTOLOAD {
73c78b0a	337	my($constname);
a0d0e21e	338	($constname = $AUTOLOAD) =~ s/.*:://;
b903fcff	339	croak "&Socket::constant not defined" if $constname eq 'constant';
	340	my ($error, $val) = constant($constname);
	341	if ($error) {
	342	croak $error;
a0d0e21e	343	}
cea00dc5	344	*$AUTOLOAD = sub { $val };
a0d0e21e	345	goto &$AUTOLOAD;
	346	}
	347
9426adcd	348	XSLoader::load 'Socket', $VERSION;
a0d0e21e	349
a0d0e21e	350	1;