Section: Sample (8)
Updated: August 2007
Return to Main Contents
sampled - sample daemon to process ~/.sample, and related files
[-vsSmM] [-i min] [-p|-P pri] [-c file] [-l file] [-d file]
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.
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.
shows the version information of sampled
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)
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
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)
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
stops all active sampled processors running at user-level, but does not affect the root sampled daemon
cleanly exits sampled
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
~/.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)
Written by v9/fakehalo. [email@example.com]
Report bugs to <firstname.lastname@example.org>.
Copyright © 2007 fakehalo.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
sample(1) samples(1) sample.conf(5) samputil(8)
- SEE ALSO
This document was created by
using the manual pages.