fsdaemon.1m (2010 09)

f
fsdaemon(1M) fsdaemon(1M)
NAME
fsdaemon - pass-through daemon for processing system commands
SYNOPSIS
/sbin/fs/fsdaemon
[-f fork]
/sbin/fs/fsdaemon
[-k]
/sbin/fs/fsdaemon
[-t]
DESCRIPTION
The
fsdaemon is a user level daemon that provides a mechanism to pass information between applica-
tions and common commands and library functionality, allowing certain applications to dynamically add
functionality to a system. This is currently only supported for the
statvfsdev class of APIs, such as:
statvfsdev(), fstatvfsdev()
, statfsdev(), fstatfsdev()).
The
fsdaemon’s API are not yet publicly available, but the commands that use the mentioned APIs
depend on this daemon to always be running in the HP-UX environments.
Options
-f fork When fsdaemon is started, indicates whether it should fork a child process and exit the
parent process or run just as the parent process and not return. A value of 1 for fork will
make
fsdaemon fork and exec a child process and then cause the parent process to exit.
-k Kills the current running instance of fsdaemon.
-t Tests and waits until fsdaemon is ready to process commands. There is a window where
fsdaemon could be started and not yet setup to process commands. The caller should invoke
fsdaemon separately with the -t option to block until fsdaemon is ready to process com-
mands.
The entries to start
fsdaemon are in the /etc/inittab file. These entries must be present to ensure
correct functionality of the system. They should appear as one of the first entries in
/etc/inittab;
placing entries before
fsdaemon entries in /etc/inittab is dangerous and unsupported.
The following are some of the HP-UX commands that use
fsdaemon via the above APIs: fstyp,
mount, and mkboot.
RETURN VALUE:
0 Successful start of
fsdaemon. If invoked with the
-f 1 option, 0 is always returned.
>0 Errno of failure that caused
fsdaemon to fail to start. This applies only if
fsdaemon was started
with the
-f 0 option.
ERRORS
If
fsdaemon is not running, the errno [ESOCKETSHUTDOWN] will be returned by an application that
invokes these APIs. If this happens, please see your system administrator to make sure
fsdaemon is
properly running.
EXAMPLES
To start
fsdaemon, such that it can be invoked without permanently blocking the calling process:
# Starts the fsdaemon.
/sbin/fs/fsdaemon -f 1
# Waits for the fsdaemon to be ready to process commands.
/sbin/fs/fsdaemon -t
To kill the currently running instance of fsdaemon:
/sbin/fs/fsdaemon -k
To check to see if the currently running instance of fsdaemon is ready and able to process requests sent
to it:
/sbin/fs/fsdaemon -t
The following entries for starting fsdaemon should appear in the /etc/inittab file:
fs01::wait:/sbin/fs/fsdaemon -k > /dev/null 2>&1
fs02:123456:respawn:/sbin/fs/fsdaemon -f 0 > /dev/null 2>&1
fs03::wait:/sbin/fs/fsdaemon -t > /dev/null 2>&1
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1