NAME¶
socket - event signalling that a socket connection has been made
SYNOPSIS¶
socket PROTO=PROTO PORT=PORT
ADDR=ADDR
socket PROTO=PROTO 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_JOB 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 socket¶
Start web server when first client connects from localhost:
start on socket PROTO=inet PORT=80 ADDR=127.0.0.1
Local socket¶
start on socket PROTO=unix PATH=/var/run/.s.pgsql.1234
Abstract socket¶
start on socket PROTO=unix 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)