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


NAME
       admswap - manage swap areas

SYNOPSIS
       admswap -o add dev-file ...

       admswap -o delete dev-file ...

       admswap -o list [ -buqv ] [ dev-file ...  ]

DESCRIPTION
       The admswap command is used to manage system swap areas.  The
       argument, dev-file, specifies a block special device file (e.g.
       virtual disk).  If dev-file is not an absolute path, it is assumed to
       be the name of a device file in the /dev/dsk directory.

   Operations
       add       Add a swap entry for dev-file to the fstab file and call
                 swapon(1M) to begin using it as a swap area.

       delete    Delete the swap entry for dev-file from the fstab file.
                 Note, however, that dev-file will continue to be used as a
                 swap area until the system is rebooted.

       list      List swap areas to stdout.

   Options
       -b        Block Size.  Produce a listing that includes total block
                 size of the individual swap area(s).

       -u        In Use Status.  Produce a listing that indicates whether or
                 not the swap area is currently in use.  A "y" is displayed
                 if the swap area is in use.  A "n" is displayed if the swap
                 area is not in use.

       -q        Quiet. Produce an unformatted listing (i.e. no headers).

       -v        Verbose.  Produce a formatted listing with headers and
                 aligned columns.  This option is enabled by default.

EXAMPLE
       The following command line would be used to add the virtual disk
       /dev/dsk/swap2 to fstab and begin using it as a swap area:

         admswap -o add swap2


OUTPUT
       The default list operation produces a list of swap areas consisting
       of a header followed by the names of the swap devices each on
       separate lines.  Additional information such as the size of each swap
       area and whether or not the swap area is currently in use can be
       obtained with the -b and -u options respectively. The -q option
       suppresses the printing of the header.

FILES
       /etc/fstab          file system table

DIAGNOSTICS
   Warnings
       None.

   Errors
       -      dev-file does not reference a valid swap device.

       -      Attempt is made to add a swap area entry that already exists
              or delete a swap area entry that doesn't exist.

       -      An attempt to begin swapping on a new swap area fails.

   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.

NOTES
       You must have appropriate privilege to perform the add and delete
       operations.  For systems supporting the DG/UX Capability Option,
       appropriate privilege is defined as having one or more specific
       capabilities enabled in the effective capability set of the user. See
       the capdefaults(5) man page for more information.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that your process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

SEE ALSO
       swapon(1M), sysadm(1M), fstab(4).  appropriateprivilege(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)