Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   4994 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

upstart-local-bridge(8)				       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)

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

Vote for polarhome