defragcron(8) System Manager's Manual defragcron(8)
NAME
defragcron - Schedules AdvFS file domains for defragmenting
SYNOPSIS
/usr/sbin/defragcron [-p] [-q] [-t nnn] [-b hh:mm] [-a hh:mm] [-l pathname] [domain...]
/usr/sbin/defragcron [-p] [-q] [-t nnn] [-T mm] [-l pathname] [domain...]
OPTIONS
Specifies that the domains are to be defragmented in parallel. If not specified, the default is to serially defragment the domains. Sup-
press informational messages. If not specified, the default is to produce informational messages. Specifies the aggregate I/O performance
threshold, the point at which the domain should be defragmented. A number from 1-100. If not specified, the default is to always defrag-
ment the domain.
The performance threshold is based on the value returned by the defragment -nv command. If this value is lower than or equal to the
value specified here, the domain is defragmented. If specified, the utility will not run before this time and will return an error
if the time is not yet reached. Specify time values using the 24-hour clock. If not specified, the default time is 01:00. If
specified, the utility will not run after this time, and will return an error if the time has been passed. Specify time values
using the 24-hour clock. If not specified, the default time is 05:00. Specifies an exact time interval, in minutes, for the
defragment utility to run. If not specified, there is no default.
If you use this option, its action overrides the before and after time checking of the -a and -b options. Specify the -l option to
direct messages to log files in the specified directory. One log file is generated for nonspecific messages and separate log files
are generated for each domain that is defragmented.
If the option is not specified, the default action is to not produce log files for the messages (which then are directed to the
standard output device).
If the option is specified, you also must specify a pathname for the directory into which the log files are to be written. The
default directory, as specified in the root crontab entry, is /usr/var/defragcron/.
The names of the log files have the following format: domain1.log, domain2.log, ..., and so on, one file for each active domain,
plus a file, defragcron.log for the nonspecific messages. If you have named a domain defragcron, messages for that domain are writ-
ten to the nonspecific messages in the defragcron.log file.
OPERANDS
Specifies one or more AdvFS file domains. If no domains are specified, the default action is for the utility to defragment all active
AdvFS file domains.
DESCRIPTION
The defragcron utility runs the defragment utility to a schedule that you specify on all active AdvFS file domains or on the active domains
you specify.
The typical use of this utility is to run it as a command in the cron daemon. See cron(8).
Unless the domain is listed in the comand line, the utility does not attempt to defragment inactive file domains (those which have no
mounted filesets). It can try to defragment file domains that have some mounted and some unmounted filesets. In this case, the utility
fails.
RESTRICTIONS
You must have root user privileges to run this utility.
All restrictions for the defragment utility are in effect for the defragcron utility.
EXIT STATUS
The utility returns a 0 (zero) on success. Otherwise, it returns a 1 and an error diagnostic.
EXAMPLES
The following example defragments all active domains that have an aggregate I/O performance threshold less than or equal to 60 for an
interval of 240 minutes: # /usr/sbin/defragcon -q -t 60 -T 240
FILES
The command's path. The path of the defragment utility.
SEE ALSO
Commands: crontab(1), cron(8), defragment(8)
defragcron(8)