IO::Socket::UNIX - Object interface for AF_UNIX domain sockets

- NAME
- SYNOPSIS
- DESCRIPTION
- CONSTRUCTOR
- METHODS
- SEE ALSO
- AUTHOR
- COPYRIGHT

# NAME

IO::Socket::UNIX - Object interface for AF_UNIX domain sockets

# SYNOPSIS

        use IO::Socket::UNIX;

# DESCRIPTION

`IO::Socket::UNIX` provides an object interface to creating and using sockets in the AF_UNIX domain. It is built upon the the IO::Socket manpage interface and inherits all the methods defined by the IO::Socket manpage.

# CONSTRUCTOR

new ( [ARGS] )
  Creates an `IO::Socket::UNIX` object, which is a reference to a newly created symbol (see the `Symbol` package). `new` optionally takes arguments, these arguments are in key-value pairs.

  In addition to the key-value pairs accepted by the IO::Socket manpage, `IO::Socket::UNIX` provides.

          Type        Type of socket (eg SOCK_STREAM or SOCK_DGRAM)
          Local       Path to local fifo
          Peer        Path to peer fifo
          Listen      Create a listen socket

  If the constructor is only passed a single argument, it is assumed to be a `Peer` specification.

       NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE

  As of VERSION 1.18 all IO::Socket objects have autoflush turned on by default. This was not the case with earlier releases.

       NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE

# METHODS

`hostpath()`
  Returns the pathname to the fifo at the local end

`peerpath()`
  Returns the pathanme to the fifo at the peer end

# SEE ALSO

the Socket manpage, the IO::Socket manpage

# AUTHOR

Graham Barr. Currently maintained by the Perl Porters. Please report all bugs to <perl5-porters@perl.org>.

# COPYRIGHT

Copyright (c) 1996-8 Graham Barr <gbarr@pobox.com>. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

IO::Socket::UNIX - Object interface for AF_UNIX domain sockets