ConsoleMessage(8) BSD System Manager's Manual ConsoleMessage(8)NAME
ConsoleMessage -- Send a message to SystemStarter
SYNOPSIS
ConsoleMessage [-v] message
ConsoleMessage [-v] -S
ConsoleMessage [-v] -F
ConsoleMessage [-v] -s service
ConsoleMessage [-v] -f service
ConsoleMessage [-v] -q setting
ConsoleMessage [-v] -b path
ConsoleMessage [-v] -u
DESCRIPTION
The ConsoleMessage utility may be used by startup item scripts to send messages to SystemStarter (see SystemStarter(8)).
The default behavior is to send the specified message to SystemStarter to be displayed on the console. SystemStarter will attempt to local-
ize the string using the current startup item's localization dictionaries.
ConsoleMessage may also be used to give feedback to SystemStarter indicating which services provided by the startup item have succeeded or
failed.
OPTIONS -v verbose mode (prints errors to stdout)
-S mark all services provided by this item as successful
-F mark all services provided by this item as failed
-s mark the service as successful
-f mark the service as failed
-q query SystemStarter for the value of the configuration variable setting (result will be printed to stdout).
-b Tell SystemStarter to load the display bundle at the specified path
-u Tell SystemStarter to unload the current display bundle
NOTES
When a service name is not specified, ConsoleMessage assumes its parent process identification (see getppid(2)) is that of a startup item
script, and uses that token to find the correct list of services provided by the current item. If the process calling ConsoleMessage is not a
startup item script, it is necessary to explicitly provide service names.
SEE ALSO SystemStarter(8)
http://www.opensource.apple.com/projects/documentation/howto/html/SystemStarter_HOWTO.html
HISTORY
The ConsoleMessage utility appeared in Darwin 6.0
Darwin April 12, 2002 Darwin
Check Out this Related Man Page
SystemStarter(8) BSD System Manager's Manual SystemStarter(8)NAME
SystemStarter -- Start, stop, and restart system services
SYNOPSIS
SystemStarter [-gvxdDqn] [action [service]]
DESCRIPTION
The SystemStarter utility is deprecated. System services should instead be described by a launchd.plist(5). See launchd(8) for more
details. The launchd utility is available on Mac OS X 10.4 and later.
In earlier versions of Mac OS X, the SystemStarter utility is used to start, stop, and restart the system services which are described in the
/Library/StartupItems/ and /System/Library/StartupItems/ paths.
The optional action argument specifies which action SystemStarter performs on the startup items. The optional service argument specifies
which startup items to perform the action on. If no service is specified, all startup items will be acted on; otherwise, only the item pro-
viding the service, any items it requires, or any items that depend on it will be acted on.
During boot SystemStarter is invoked by launchd(8) and is responsible for starting all startup items in an order that satisfies each item's
requirements.
ACTIONS
start start all items, or start the item that provides the specified service and all items providing services it requires.
stop stop all items, or stop the item that provides the specified service and all items that depend on it.
restart restart all items, or restart the item providing the specified service.
OPTIONS -g (ignored)
-v verbose (text mode) startup
-x (ignored)
-r (ignored)
-d print debugging output
-D print debugging output and dependencies
-q be quiet (disable debugging output)
-n don't actually perform action on items (no-run mode)
NOTES
Unless an explicit call to ConsoleMessage is made, SystemStarter examines the exit status of the startup item scripts to determine the suc-
cess or failure of the services provided by that script.
FILES
/Library/StartupItems/ User-installed startup items.
/System/Library/StartupItems/ System-provided startup items.
SEE ALSO ConsoleMessage(8), launchd(8), launchd.plist(5), rc(8)HISTORY
The SystemStarter utility appeared in Darwin 1.0 and was extended in Darwin 6.0 to support partial startup and interprocess communication.
SystemStarter was deprecated by launchd(8) in Darwin 8.0.
Darwin April 12, 2002 Darwin