upstart-local-bridge

SYNOPSIS
       upstart-local-bridge [OPTIONS]...

DESCRIPTION
       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.

OPTIONS
       --any-user
              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.

       --daemon
              Detach and run in the background.

       --debug
              Enable debugging output.

       --event event
              Specify name of event to emit on receipt of a name=value pair.

       --help 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.

       --verbose
              Enable verbose output.

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

       o   SOCKET_TYPE=unix

       o   SOCKET_VARIANT=[named|abstract] Sub-type of socket.

       o   CLIENT_UID=UID User ID of connected client.

       o   CLIENT_GID=GID Group ID of connected client.

       o   CLIENT_PID=PID Process ID of connected client.

       o   SOCKET_PATH=PATH

EXAMPLES
       upstart-local-bridge --event=foo --path=/var/foo/bar
           Listen  on  local socket /var/foo/bar and when a name=value pair is
           the last must already exist before the bridge starts.

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

AUTHOR
       Written by James Hunt <james.hunt@canonical.com>

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

COPYRIGHT
       Copyright (C) 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.

SEE ALSO
       init(5) init(8)

upstart                           2013-07-23           upstart-local-bridge(8)