Administration Guide : Command-line manual pages

FPOD(8) manual page

Name

fpod - For Placement Only creator daemon

Synopsis

/usr/etc/appletalk/fpod [ -dlevel | -D ] [ -j concurrent ] [ -k keep ] [ -r freq ] [ -t timeout ]
[ -h ctime ] [ -i suffixlist ] [ servername ]

Description

Fpod receives information packets from dtrebuild(8) and ksd(8) and generates For Placement Only versions of images as needed by calling mkfpo(1) . Fpod decides what sort of FPOs to make based on the options stored in fpovolopts(5) for the volume. If a servername is specified, fpod registers (locally only) with nbpd using that name; otherwise, it will register as ``fpod.''

Fpod also receives packets from WebNative Venture programs for preview and metadata gathering for the Venture database. This is mainly done for serialization - only one process of each type listed in the fpod.conf file (found in Venture's var directory) will be run at a time.

The -j option sets the maximum number of mkfpo(1) processes that can run in parallel to concurrent. If not specified fpod allows "number of CPUs - 1" (but at least 1) concurrent mkfpo(1) processes.

The -t option sets the time limit that any given mkfpo process will be allowed to run. If a mkfpo process runs for longer than timeout real-time minutes, it is stopped, and the file that was being processed is not processed again, for the life of the fpod process. Timeouts for Venture queues are set via the fpod.conf file.

The -h option sets ctime, the timeout value (in seconds, default 10) for how long to hold a .HSancillary cache open. Setting it to zero essentially disables the .HSancillary cache. Open .HSancillary files can prevent removal of folders on volumes on top of filesystems served by NFS.

The -i option sets a comma-separated suffixlist list of case-insensitive suffixes (the part of a filename after the last period) that fpod will force to get no FPO or WEB preview made, storing a Don't Need FPO marker instead of preview(s) if a file has one of the listed suffixes.

There are two options for turning on debugging. The -d option sets debugging to the hexadecimal number level (a bitmask of debugging options documented in opidebug(5) ). The -D option turns on all debugging, including sending debug messages to stderr instead of the AppleTalk log file. Fpod runs in the background unless the -D option is given, or there is no space between the -d and level.

If fpod receives a USR1 signal, it will log the contents of its job queues (including those images that mkfpo(1) fails on) to /var/adm/appletalk/fpodq/dump (after truncating it). If the file /var/adm/appletalk/fpodUSRf exists when the USR1 signal arrives, it may contain parameters that request actions other than the default log of the queues.

The -r and -k options set parameters for ``rotating'' the log file. Without a -r option, fpod will not do anything but append messages to the fpo_log file in the Admin directory. At SYSTEM startup time, the fpo_log file will be renamed to fpo_log.old. The -r option enables log rotation, and fpo_log.old becomes a directory where fpo_log gets moved every freq days. The moved files have a numerical name representing the date they were moved, and will be permanently removed after keep days. The default keep value is 62.

Files

/var/adm/appletalk/fpodq
Directory containing various queue logs and the venture log (named vlog).
/var/adm/appletalk/fpovolopts
Contains per-volume fpo options, passed on to mkfpo.
/var/adm/appletalk/fpo_log
File where error and debug messages from fpod are logged.
/var/adm/appletalk/fpodUSRf
Communication file for the USR1 signal.
/usr/etc/venture/var/fpod.conf
File where WebNative Venture processes are registered.

See Also

ksd(8) , mkfpo(1) , fpovolopts(5) , opidebug(5)