upstart-local-bridge(8) Bridge between Upstart and a local client socket


upstart-local-bridge [OPTIONS]...


upstart-local-bridge listens on a local domain socket for name=value pairs and creates init(8) events for them.

The local unix domain socket can be either named or abstract.


By default the bridge will only accept connections from clients running under the same user ID as the bridge itself. This option allows connections from any user.
Detach and run in the background.
Enable debugging output.
--event event
Specify name of event to emit on receipt of a name=value pair.
Show brief usage summary.
--path path
Specify path for local/abstract socket to listen on. If the first byte of path is an '@', the socket will be created as an abstract socket.
Enable verbose output.


The following environment variables are added automatically to the event to be emitted, with the name=value pair being added as the last variable.

  • SOCKET_TYPE=unix
  • SOCKET_VARIANT=[named|abstract] Sub-type of socket.
  • CLIENT_UID=UID User ID of connected client.
  • CLIENT_GID=GID Group ID of connected client.
  • CLIENT_PID=PID Process ID of connected client.


upstart-local-bridge --event=foo --path=/var/foo/bar
Listen on local socket /var/foo/bar and when a name=value pair is read, emit an event of the form:

foo SOCKET_TYPE=unix SOCKET_VARIANT=named SOCKET_PATH=/var/foo/bar name=value
upstart-local-bridge --event=bar [email protected]/var/foo/bar
Listen on abstract socket @/var/foo/bar and when a name=value pair is read, emit an event of the form:

bar SOCKET_TYPE=unix SOCKET_VARIANT=abstract [email protected]/var/foo/bar name=value


  • If a named local socket is specified, all path elements except for the last must already exist before the bridge starts.


  • Only a single client connection is serviced at any one time.


Written by James Hunt <[email protected]>


Copyright © 2013 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.