unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



defragcron(8)							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 speci-
      fied, the	default	is to always defragment	the domain.

      The performance threshold	is based on the	value returned by the defrag-
      ment -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 util-
      ity 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 non-
      specific 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	dae-
  mon.	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)