Open Source Software

upstart-local-bridge(8)



NAME

   upstart-local-bridge - Bridge between Upstart and a local client socket
   connection.

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.

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

   *   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
       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 --path=@/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 SOCKET_PATH=@/var/foo/bar name=value

NOTES

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

LIMITATIONS

   *   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  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)



Free and Open Source Software


Free Software Video

Useful Programs

Free Online Courses

Open Opportunity

Open Business