Index for Section 8

Alphabetical listing for D

Bottom of page

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
  -p  Specifies that the domains are to be defragmented in parallel.  If not
      specified, the default is to serially defragment the domains.

  -q  Suppress informational messages.	If not specified, the default is to
      produce informational messages.

  -t nnn
      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 defragment 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.

  -b hh:mm
      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.

  -a hh:mm
      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.

  -T mmm
      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.

  -l pathname
      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 written to the
      nonspecific messages in the defragcron.log file.

OPERANDS
  domain ...
      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
  /usr/sbin/defragcron
      The command's path.

  /usr/sbin/defragment
      The path of the defragment utility.

SEE ALSO
  Commands: crontab(1), cron(8), defragment(8)

Index for Section 8

Alphabetical listing for D

Top of page