Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pcastctl(8) [osx man page]

pcastctl(8)						    BSD System Manager's Manual 					       pcastctl(8)

pcastctl -- Podcast Producer daemons control interface SYNOPSIS
pcastctl status target on|off|start|stop|restart OPTIONS
The available options are as follows: status print status of running daemons target affect agent or server daemon start|stop|restart explicitly start/stop/restart daemon. Note that 'restart' will kill all instances of a given daemon, as will 'stop' if none is specified in the pid file. RETURN VALUES
0 Completed succesfully. 1 Action failed 10 Not run as root. 50 Target not recognized: use 'a', or 's'. 51 Action not recognized: use start|stop|restart 52 Executables not found; may need to reinstall Podcast Producer. 53 Process directory not found; may need to reinstall Mac OS X. 54 Timeout waiting for action to complete. 55 Launchd manipulation failure. FILES
/usr/libexec/podcastproducer/pcastagentd Podcast Producer agent daemon /usr/share/podcastproducer/pcastserverd Podcast Producer server daemon /var/run/ Podcast Producer agent process ID /var/run/ Podcast Producer server process ID /System/Library/LaunchDaemons/ Launchd agent daemon control file /System/Library/LaunchDaemons/ Launchd server daemon control file EXAMPLES
status of Podcast Producer agent daemon $ pcastctl agent status edit launchd configuration to launch server on system startup $ pcastctl server on DIAGNOSTICS
Warning: Warning: ## copies of (pcastagentd|pcastserverd) already running Trying to launch another daemon when one or more already running; will usually succeed, but may cause unpredictable behavior. See also RETURN VALUES, above. ERRORS
Error: failed to launch (executable) Tried to start/restart a give daemon, but failed. Error: process 'executable' not currently running Tried to kill a process which did not exist. SEE ALSO
pcast(1) launchd(8) HISTORY
This program was first introduced in Mac OS X 10.5 "Leopard". It was inspired by xgridctl(8). BUGS
pcastctl(8) uses kill -TERM to allow the daemons a chance to die gracefully; there is currently no way to force a kill -KILL. Bug reports can be sent to Feedback can be sent to Mac OS September 29, 2004 Mac OS

Check Out this Related Man Page

launchd(8)						    BSD System Manager's Manual 						launchd(8)

launchd -- System wide and per-user daemon/agent manager DESCRIPTION
launchd manages processes, both for the system as a whole and for individual users. The primary and preferred interface to launchd is via the 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 configu- ration files. launchd also manages XPC services that are bundled within applications and frameworks on the system. During boot launchd is invoked by the kernel to run as the first process on the system and to further bootstrap the rest of the system. You cannot invoke launchd directly. NOTES
On Darwin operating systems, the canonical way to launch a daemon is through launchd as opposed to traditional POSIX and POSIX-like mecha- nisms or mechanisms provided in earlier versions of OS X. These alternate methods should be considered deprecated and not suitable for new projects. In the launchd lexicon, a daemon is, by definition, a system-wide service of which there is one instance for all clients. An agent is a ser- vice that runs on a per-user basis. Daemons should not attempt to display UI or interact directly with a user's login session. Any and all work that involves interacting with a user should be done through agents. XPC services which are marked with a ServiceType of System are functionally equivalent to daemons and run in the same environment, sharing the same Mach bootstrap namespace. XPC services which are marked with a ServiceType of User are equivalent to agents with the LimitLoadToSes- sionType key specifying the Background session and run in the same environment, sharing the same Mach bootstrap namespace. See launchd.plist(5) for more information about user sessions. On Darwin platforms, a user environment includes a specific Mach bootstrap subset, audit session and other characteristics not recognized by POSIX. Therefore, making the appropriate setuid(2) and setgid(2) system calls is not sufficient to completely assume the identity for a given user. Running a service as a launchd agent or a per-user XPC service is the only way to run a process with a complete identity of that user. FILES
~/Library/LaunchAgents Per-user agents provided by the user. /Library/LaunchAgents Per-user agents provided by the administrator. /Library/LaunchDaemons System-wide daemons provided by the administrator. /System/Library/LaunchAgents Per-user agents provided by Apple. /System/Library/LaunchDaemons System-wide daemons provided by Apple. SEE ALSO
launchctl(1), launchd.plist(5), DEVELOPER DOCUMENTATION
The Daemons and Services Programming Guide can be found at the following URL: Darwin 25 November, 2013 Darwin
Man Page