admdumpdevice(1M)              DG/UX R4.11MU05             admdumpdevice(1M)


NAME
       admdumpdevice - manage the dump device table

SYNOPSIS
       admdumpdevice -o add [ -b block-size ] [ -c capacity ] [ -d
                 description ] name

       admdumpdevice -o modify [ -b block-size ] [ -c capacity ] [ -d
                 description ] [ -n new-name ] name

       admdumpdevice -o delete name ...

       admdumpdevice -o list [ -qv ] [ name ...  ]

DESCRIPTION
       admdumpdevice manages the table of dump devices.  The entries in the
       table describe media types which can be used for creating backups
       with dump2(1M) or admbackup(1M).  Each entry contains a medium name,
       the block size to use for reading and writing, the capacity (in
       bytes) of the medium, and a description of the medium.

   Operations
       The admdumpdevice command provides operations for adding, deleting,
       modifying, or listing entries in the table.

       add       Append a new entry to the table.

       delete    Remove an existing entry from the table.

       modify    Change an existing entry in the table.

       list      Display one or more entries from the table.  If no name is
                 given, or name is the special keyword all, all entries from
                 the table are displayed.

   Options
       The following options may be used:

       -b block-size
                 Use block-size as the number of 1024-byte blocks to
                 transfer in each read(2) or write(2) operation to the
                 medium.  The default is 16.

       -c capacity
                 Use capacity as the total capacity (in bytes) of the
                 medium.  The value must be a number, possibly followed by a
                 upper- or lower-case b, k, m, or g to indicate bytes,
                 kilobytes, megabytes, or gigabytes.  The default is 150M.

       -d description
                 Use description as a text string describing the medium.

       -n new-name
                 Change the name of the medium to new-name.  The default is
                 name.

       -q        Use quiet mode.  Headers for the listing are not displayed.

       -v        Use verbose mode.  Headers for the listing are displayed.
                 This is the default behavior.

EXAMPLE
       To add a 525 Mbyte cartridge tape drive to the media table, use a
       command line like

       admdumpdevice -o add -c 525M -d "525 MB Cartridge Tape" cartridge525

FILES
       /etc/dumptab   The dump device file.

OUTPUT
       The list operation displays the medium name, block size, capacity in
       bytes, and description for each name given.

DIAGNOSTICS
   Warnings
        -  An attempt was made to list a non-existent entry.

   Errors
        -  An attempt was made to add an already-existing entry.

        -  An attempt was made to delete a non-existent entry.

        -  An attempt was made to modify a non-existent entry.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       admbackup(1M), dump2(1M), sysadm(1M), dumptab(4).  cap_defaults(5).

NOTES
       You must have write permission to the dump device file to use the
       add, delete, and modify operations.  To have such permission, you
       must have appropriate privilege, which, on a generic DG/UX system,
       means that you have superuser privilege, or an effective UID of root.
       See the appropriate_privilege(5) man page for more information.

       On a system that supports the DG/UX Capability option, appropriate
       privilege is defined as having one one or more specific capabilities
       enabled in the effective capability set of the user.  See
       cap_defaults(5) for the default capabilities for this command.


Licensed material--property of copyright holder(s)