unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



uucleanup(8)							 uucleanup(8)



NAME

  uucleanup - Deletes selected old files from the uucp spool directory

SYNOPSIS

  /usr/lib/uucp/uucleanup [options]

OPTIONS

  If you specify one of	the following options, you must	provide	a value	for
  days.	The default value listed is used if the	option is not specified.

  -C days
      Removes any C.* (Command)	files as old as	or older than the number of
      days specified by	days, and sends	appropriate information	to the
      requester. The default is	7 days.	 The -C	and -W options cannot be com-
      bined.

  -D days
      Removes any D.* (Data) files as old as or	older than the number of days
      specified	in days. Also attempts to deliver any remaining	mail mes-
      sages.  The default is 7 days.

  -m string
      Includes a specified line	of text	in the warning message generated by
      the -W option.  The default line is:


	   We have been	unable to contact machine
	   machine_name	since you queued your job.

      The -m option can	be used	only with the -W option.

  -o days
      Removes files in addition	to those specified by the -C, -D, and -X
      options that are as old as or older than the number of days specified
      in days.	The default is 2 days.

  -s system
      Executes uucleanup only on the spool directory specified by system.
      The default is to	clean up all uucp spool	directories.

      Note that	system names can contain only ASCII characters.

  -T days
      Removes TM.* (Temporary) files as	old as or older	than the number	of
      days specified by	the days argument.  Also attempts to deliver any
      remaining	mail messages. The default is 7	days.

  -W days
      Sends a mail message to the requester warning that C.* files as old as
      or older than the	number of days specified in days are still in the
      spool directory. The message includes the	job ID and, in the case	of
      mail, the	mail message.  The administrator can use the -m	option to
      include a	message	line telling who to call to check the problem.	The
      default is 1 day.

  -X days
      Removes any X.* (Execute)	files as old as	or older than the number of
      days specified in	days. The default is 2 days.

  -x level
      Displays debugging information on	the screen of the local	terminal;
      level must be an integer from 0 to 9.  The higher	the number, the	more
      detailed the debugging information.

DESCRIPTION

  The uucleanup	program	removes	outdated files from the	spool directory
  (/usr/spool/uucp).  The uucleanup program scans the /usr/spool/uucp direc-
  tory for old files and takes appropriate action to remove them in a useful
  way. The uucleanup command performs the following tasks:

    +  Informs the requester of	send/receive requests for systems that cannot
       be reached

    +  Warns users about requests that wait  more than a specified number of
       days (the default is 1 day)

    +  Returns mail that cannot	be delivered to	the sender

    +  Removes all other files older than a specified number of	days from the
       spool directory.

  The uucleanup	program	is not usually invoked from the	command	line, but is
  executed by the shell	procedure uudemon.cleanu located in /usr/lib/uucp,
  which	in turn	is started by the cron script located in
  /usr/adm/cron/crontabs/uucp. Only someone with superuser privileges can
  issue	the uucleanup command from the command line.

  To enable automatic cleanup, edit the	file /usr/adm/cron/crontabs/uucp.
  Remove the # (number sign) from the beginning	of the uudemon.cleanu line.

EXAMPLES

   1.  To locate files,	enter:


	    # uucleanup	-W 2

       This form of the	command	locates	C.* (Command) files 2 or more days
       old and warns the requesters that the files have	not been sent.

   2.  To send a message with a	warning, enter:


	    # uucleanup	-W 2 -m	"Contact the System Admin about	these files."

       This form of the	command	 locates C.* (Command) files 1 or more days
       old (the	default), warns	requesters their files have not	been sent,
       and gives them the message:


	    Contact the	System Admin about these files.

   3.  To clean	up command files that are 8 or more days old, enter:


	    # uucleanup	-C 8

       This form of the	command	removes	all C.*	(Command) files	8 or more
       days old	and sends an appropriate message to the	requesters. Other
       uucp spool files	are removed based on the default value for that	type.

   4.  To clean	up data	and execute files, enter:


	    # uucleanup	-D 7 -X	3

       This form of the	command	removes	all D.*	(Data) files 7 or more days
       old (the	default) and all X.* (Execute) files older than	3 days and
       attempts	to deliver all undelivered mail. Remaining uucp	spool files
       are removed based on the	default	value for that type.

   5.  To clean	up other files,	enter:


	    # uucleanup	-o 2

       This form of the	command	removes	uucp spool files according to their
       default values except for other files, which are	removed	if 2 days or
       older.

   6.  To clean	up all files at	once, enter the	command	without	options:


	    # uucleanup

       This form of the	command	removes	all C.*, D.*, and X.* files, and all
       other files older than the default times.

   7.  To clean	up Command files for system hera, enter:


	    # uucleanup	-s hera	-C 5

       This form of the	command	removes	all C.*	files 5	or more	days old and
       the other uucp spool files according to their default files for system
       hera. (The path to these	files is /usr/spool/uucp/hera/*.)

FILES

  /usr/lib/uucp/uucleanup
      Specifies	the command path.

  /usr/sbin/cron
      File that	starts uudemon.cleanu shell procedure.

  /usr/lib/uucp
      Contains all the configuration files for uucp, and the uudemon.cleanu
      shell procedure.

  /usr/spool/cron/crontabs/uucp
      Schedules	uucp jobs for the cron daemon, including the uudemon.cleanu
      shell procedure.

  /usr/spool/uucp
      Contains files removed by	the uucleanup command.







SEE ALSO

  Commands: uucp(1), uustat(1),	uux(1),	cron(8)