SIMPLE SOLUTIONS

SOCKET-EVENT(7) - man page online | overview, conventions, and miscellany

Event signalling that a socket connection has been made.

Chapter
2011-03-08
socket-event(7)                  Miscellaneous Information Manual                 socket-event(7)

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 connec‐ tion 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 corre‐ sponding 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 <@netsplit.com> Manual page written by James Hunt <@ubuntu.com>

BUGS

Report bugs at <https://launchpad.net/upstart/+bugs>
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)
upstart 2011-03-08 socket-event(7)
This manual Reference Other manuals
socket-event(7) referred by upstart(8) | upstart-events(7) | upstart-socket-bridge(8)
refer to accept(2) | socket(2) | socket(7) | upstart(5) | upstart-socket-bridge(8)