.Nd System wide and per-user daemon/agent manager
.Sh SYNOPSIS
.Nm
-.Op Fl v
+.Op Fl d
+.Op Fl D
.Op Fl s
-.Op Fl x
+.Op Fl S Ar SessionType
.Op Ar -- command Op Ar args ...
.Sh DESCRIPTION
.Nm
-manages daemons, both for the system as a whole and for individual users. Ideal daemons can launch
-on demand based on criteria specified in their respective XML property lists located in one of the
-directories specified in the FILES section.
+manages processes, both for the system as a whole and for individual users.
+The primary and preferred interface to
+.Nm
+is via the
+.Xr launchctl 1
+tool which (among other options) allows the user or administrator to load and unload jobs.
+Where possible, it is preferable for jobs to launch on demand based on criteria specified
+in their respective configuration files.
.Pp
When run with a command, a specific instance of
.Nm
During boot
.Nm
is invoked by the kernel to run as the first process on the system and to further bootstrap the rest of the system.
+.Sh OPTIONS
+.Bl -tag -width -indent
+.It Fl D
+Debug. Prints syslog messages to stderr and adjusts logging via
+.Xr syslog 3
+to LOG_DEBUG.
+.El
.Sh OPTIONS WHEN RUN AS PID 1
.Bl -tag -width -indent
-.It Fl v
-Verbose boot.
.It Fl s
Single user mode. Instructs
.Nm launchd
to give a shell prompt before booting the system.
-.It Fl x
-Safe mode boot. Instructs the system to boot conservatively.
+.El
+.Sh ENVIRONMENTAL VARIABLES
+.Bl -tag -width -indent
+.It Pa LAUNCHD_SOCKET
+This variable is exported when invoking a command via the launchd command line. It informs launchctl how to find the correct launchd to talk to.
.El
.Sh NOTES
In Darwin it is preferable to have your daemon launch via launchd instead of modifying
projects / apple / launchd.git / blobdiff