NAME

perphup - trigger a perpd(8) rescan

SYNOPSIS

perphup [-hV] [-q] [-t] [ basedir ]

DESCRIPTION

perphup is used to trigger perpd(8) to rescan its service installation directory. perphup may also be used to trigger the controlled shutdown of perpd(8) and all of its services.

perphup looks for an instance of perpd(8) running on the argument given by basedir. Otherwise, perphup looks for a value in the environmental variable PERP_BASE. If neither of these are defined or are empty, perphup uses a compiled-in default, normally /etc/perp.

When perphup finds the perpd(8) process, it sends it a SIGHUP signal.

OPTIONS

-h: Help. Print a brief usage message to stderr and exit.
-q: Quiet. Normally after successfully finding and triggering a perpd(8) process, perphup prints a brief message to stderr. The -q option may be used to suppress this message.
-t: Term. Normally perphup sends a SIGHUP signal to the perpd(8) process to trigger a rescan. The -t option is used to send a SIGTERM instead, and triggers the perpd(8) shutdown sequence.
-V: Version. Print the version number to stderr and exit.

EXIT STATUS

perphup exits with the following values:

0: Success. An active perpd(8) process was found and triggered.
100: Usage error. For unknown options or other command-line errors. Prints a brief diagnostic message to stderr on exit.
111: System error. Unexpected failures during system calls, privilege and/or resource problems, or configuration problems in the perpd(8) directory. Prints a brief diagnostic message to stderr on exit.

AUTHOR