fsphoto(ADM)                    19 June 1992                    fsphoto(ADM)


 Name

    fsphoto - perform periodic semi-automated system backups

 Syntax

    fsphoto [ -i ] schedule [ drive ]

 Description

    fsphoto, in conjunction with fsave(ADM), provides a semi-automated inter-
    face to xbackup(ADM) and cpio(C) for backing-up filesystems (xbackup can
    only be used to back up XENIX fileystems).  A human operator is required
    to mount and dismount tapes or floppies at the appropriate times, so some
    interaction is necessary, but all such interaction is kept to a minimum
    to reduce the potential for human error.

    The selection and timing of backups for all filesystems is governed by
    the schedule(ADM) database.  The system administrator must set up this
    file, and make arrangements to run fsphoto on the implicitly defined
    schedule (normally once per weekday).  fsphoto can be invoked most easily
    from the sysadmsh(ADM).  fsphoto interprets schedule, and for each file-
    system that should be backed-up on that day, runs fsave to interact with
    the operator and backup the filesystem without error.

    The optional argument drive specifies the magtape or floppy device to
    use; the default is specified in the schedule file.

    Backups may be postponed (via fsave) or interrupted.  The resulting
    ``partial'' backups are automatically resumed the next time fsphoto is
    run:  any missed filesystems are backed-up as if the original backup had
    not been delayed.  The -i flag ignores any pending partial backups.

    If there is a pending partial backup, the normally scheduled backups are
    not done.  This means that if a partial backup is resumed, and the nor-
    mally scheduled backups are to be done, fsphoto must be run twice.

    You must be the super user to use this program.

 Files

    /usr/lib/sysadmin/schedule
                             Database describing which filesystems are to be
                             backed-up when, and at what dump level.
    /dev/tty                 Source of interactive input.
    /usr/lib/sysadmin/past   Record of filesystems successfully backed-up in
                             the pending partial backup.
    /tmp/backup$$            Temporary file for recording successfully
                             backed-up filesystems.

 See also

    basename(C), fsave(ADM), schedule(ADM), xbackup(ADM),

 Diagnostics

    fsphoto complains of syntax errors in schedule, and exits with a status
    of 1.

    fsphoto complains about illegal or incorrect arguments, and exits with a
    status of 1.

    An interrupt will cause an exit status of 2.

 Notes

    If a drive is explicitly given, the ``raw'' (/dev/r*) form of the device
    should be used.

 Value added

    fsphoto is an extension to AT&T System V developed by The Santa Cruz
    Operation, Inc.