SAMPLED

Section: Sample (8)
Updated: August 2007
Index Return to Main Contents

NAME

sampled - sample daemon to process ~/.sample, and related files

SYNOPSIS

sampled [-vsSmM] [-i min] [-p|-P pri] [-c file] [-l file] [-d file]

DESCRIPTION

sampled is a background daemon intended to be run at operating system launch time. sampled processes the data of users with ~/.sample, and related files to monitor specified outdated/oversized files. in a sense, sampled does the file sampling itself.

sampled, in most situations, should be launched via samputil, the provided shell script interface.

OPTIONS

all of the following command-line options have corresponding values for use in the sample.conf configuration file, and it is recommended that configuration values are set there for consistent use. however, all command-line options override sample.conf configuration values.

-v: shows the version information of sampled
-s: allows users that have shells outside of the /etc/shells file to have processable ~/.sample files (depending on the system, this may be a forced option)
-S: allows users to set their own shell for handling outdated files. this is set via the SHELL=/path/to/sh in the user's ~/.sample file
-m: allows multiple processes (processors) for a single user. this is to say that if the previous instance of the sampled processor was running for a particular user it would allow the daemon to run another, where normally it would not. essentially, this means, by default, a user is given one main process to handle their ~/.sample files, this option turns that off and allows multiple processes (this will stop the monitoring of this level of processes due to potential overhead, which may result in less sample.log logging and minimal functionality loss)
-M: allows multiple (sub) processes for a user's processor instance, so it does not wait for the previous (sub) process to finish. this is a bad idea to enable, and leads to a high level of processes at one time (this will stop the monitoring of this level of processes due to potential overhead, which may result in less sample.log logging and minimal functionality loss)
-i min: makes sampled process ~/.sample files every min number of minute(s), instead of every single minute
-p pri: makes the sampled user processes (processors) run with the process priority pri (-20 to 20)
-P pri: makes the sampled daemon (core) process run with the process priority pri (-20 to 20)
-c file: specify an alternate sample.conf configuration file to use
-l file: specify an alternate log file to write sampled warnings/errors to
-d file: specify an alternate pid file to write to

SIGNALS

SIGHUP: stops all active sampled processors running at user-level, but does not affect the root sampled daemon
SIGUSR1: cleanly exits sampled
SIGUSR2: clears sampled user-cache. this should be signaled if a (new) user is added to the system. the cache is cleared automatically if /etc/passwd or /etc/shells (where available) are modified

FILES

~/.sample              (explained in the sample manual)
~/.sample_spool/       (explained in the sampled manual)
/etc/sampletab/        (explained in the sample manual)
/etc/sample.conf       (explained in the sample.conf manual)
/etc/passwd            (if compiled with --enable-strict-passwd)
/etc/shells            (where supported)

AUTHOR

Written by v9/fakehalo. [v9@fakehalo.us]

BUGS

Report bugs to <v9@fakehalo.us>.

COPYRIGHT

This document was created by man2html, using the manual pages.