upstart-local-bridge
Section: Maintenance Commands (8)
Updated: 2013-07-23
Index
Return to Main Contents
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EVENT DETAILS
-
- EXAMPLES
-
- NOTES
-
- LIMITATIONS
-
- AUTHOR
-
- BUGS
-
- COPYRIGHT
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 20:33:48 GMT, May 19, 2024