NAME

       socket - event signalling that a socket connection has been made

SYNOPSIS

       socket PROTO=PROTO PORT=PORT ADDR=ADDR

       socket PROTO=PROTO SOCKET_PATH=PATH

DESCRIPTION

       The  socket  event  is  generated  by  the  upstart-socket-bridge(8)  daemon when a socket
       connection is made  whose  details  match  the  socket  event  condition  and  environment
       specified in a jobs start on or stop on stanza.

       When  an  incoming  connection is detected, the file descriptor representing the socket is
       passed to the job in question to allow it to accept(2) the connection.  Additionally,  the
       environment  variable UPSTART_EVENTS will contain the name of the event ("socket") and the
       environment  variable  UPSTART_FDS  will  contain  the  number  of  the  file   descriptor
       corresponding to the listening socket.

EXAMPLES

   Internet (IPv4) socket
       Start web server when first client connects from localhost:

              start on socket PROTO=inet PORT=80 ADDR=127.0.0.1

   Internet (IPv6) socket
       Start job when a client connects from localhost:

              start on socket PROTO=inet6 PORT=80 ADDR=::1

   Local socket
              start on socket PROTO=unix SOCKET_PATH=/var/run/.s.pgsql.1234

   Abstract socket
              start on socket PROTO=unix SOCKET_PATH=@/at/upstart/example

AUTHOR

       Written by Scott James Remnant <scott@netsplit.com>

       Manual page written by James Hunt <james.hunt@ubuntu.com>

BUGS

       Report bugs at <https://launchpad.net/upstart/+bugs>

COPYRIGHT

       Copyright © 2011 Canonical Ltd.

       This  is  free software; see the source for copying conditions.  There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       init(5) init(8) socket(2) socket(7) upstart-socket-bridge(8)