swap(8)                             CLIX                             swap(8)



  NAME

    swap - Adds to, deletes from, or lists system swap space

  SYNOPSIS

    /etc/swap -a swapdev swaplow swaplen

    /etc/swap -d swapdev swaplow

    /etc/swap -l

  FLAGS

    -a   Adds a swap partition to the system swap table.

    -d   Deletes a swap partition from the system swap table.

    -l   Lists the current contents of the system swap table.

  DESCRIPTION

    The swap command allows the system administrator to add a swap partition
    to the system swap table, delete a swap partition from the system swap
    table, or list the current contents of the system swap table.  This
    utility is useful if an administrator wishes to distribute swap space
    across multiple disk drives or increase the available swap space on a busy
    system.

    The following arguments are used to define the swap space:

    swapdev   The pathname of the partition to be added to or deleted from the
              system swap table.

    swaplow   The starting block for the swap space.  A nonzero value
              specifies an offset into the partition, while a value of 0
              specifies that swap space starts at the beginning of the
              specified partition.

    swaplen   The amount of space in the partition (in 512-byte blocks) to be
              reserved as swap space.

  EXAMPLES

    1.  The following lists the current contents of the system swap table:

        /etc/swap -l


    2.  Assume that you have a potential swap area on a secondary disk in the
        form of a partition (/dev/dsk/s1u0p7.1) containing 50,000 blocks of



  2/94 - Intergraph Corporation                                              1

  swap(8)                             CLIX                             swap(8)



        space.  The following adds the specified partition to the swap table
        and, starting at the beginning of the partition, reserves the entire
        partition as swap space:

        /etc/swap -a /dev/dsk/s1u0p7.1 0 50000


    3.  The following deletes the previously added swap partition from the
        system swap table:

        /etc/swap -d /dev/dsk/s1u0p7.1 0


  CAUTIONS

    Contiguous swap space cannot be added to partitions already listed in the
    system swap table.  Each additional partition is treated separately.

    If the value of swaplow is nonzero, the value of swaplen must be reduced
    by the value of swaplow to keep the swap area from overrunning the
    partition.

  EXIT VALUES

    The swap command returns an error code of 1 for incorrect command usage
    and an error code of 2 for incorrect add/delete command usage.  This
    command returns an error code of 3 if a list, add, or delete command
    fails.

  RELATED INFORMATION

    Functions:  swap(2)






















  2                                              Intergraph Corporation - 2/94