Login or Register to Ask a Question and Join Our Community

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)

NAME

     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/pcastagentd.pid
	     Podcast Producer agent process ID

     /var/run/pcastserverd.pid
	     Podcast Producer server process ID

     /System/Library/LaunchDaemons/com.apple.pcastagentd.plist
	     Launchd agent daemon control file

     /System/Library/LaunchDaemons/com.apple.pcastserverd.plist
	     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 bugreport.apple.com

     Feedback can be sent to podcastproducer@apple.com

Mac OS								September 29, 2004							    Mac OS

Check Out this Related Man Page

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

NAME

     launchd -- System wide and per-user daemon/agent manager

SYNOPSIS

     launchd [-d] [-D] [-s] [-S SessionType] [-- command [args ...]]

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 configuration files.

     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.

ENVIRONMENTAL VARIABLES

     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.

NOTES

     In Darwin, the canonical way to launch a daemon is through launchd as opposed to more traditional mechanisms or mechanisms provided in ear-
     lier versions of Mac 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
     service 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.

     If you wish your service to run as a certain user, in that user's environment, making it a launchd agent is the ONLY supported means of
     accomplishing this on Mac OS X. In other words, it is not sufficient to perform a setuid(2) to become a user in the truest sense on Mac OS X.

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 Mac OS X.
     /System/Library/LaunchDaemons  System-wide daemons provided by Mac OS X.

SEE ALSO

     launchctl(1), launchd.plist(5),

Darwin								    1 May, 2009 							    Darwin
Man Page