This manual page is for Mac OS X version 10.6.3

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


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

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...