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 applications 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 commands.

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 

WARNINGS

The fsdaemon's APIs are not yet publicly available, but the commands that use the mentioned statvfsdev family of APIs depend on this daemon to always be running on HP-UX environments. The administrator is not expected to invoke the fsdaemon command from the shell prompt; it should always be started via an entry in /etc/inittab.

This manpage is provided for administrator's trouble shooting purposes, and to allow the system administrator to repair the /etc/inittab entries for this daemon in case of corruption.

The interface/options provided in this manpage are HP-UX release specific, and may be different in future releases.

AUTHOR

fsdaemon was developed by HP.