4.4BSD/usr/share/man/cat2/swapon.0

SWAPON(2)                   BSD Programmer's Manual                  SWAPON(2)

NNAAMMEE
     sswwaappoonn - add a swap device for interleaved paging/swapping

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<uunniissttdd..hh>>

     _i_n_t
     sswwaappoonn(_c_o_n_s_t _c_h_a_r _*_s_p_e_c_i_a_l);

DDEESSCCRRIIPPTTIIOONN
     SSwwaappoonn() makes the block device _s_p_e_c_i_a_l available to the system for allo-
     cation for paging and swapping.  The names of potentially available de-
     vices are known to the system and defined at system configuration time.
     The size of the swap area on _s_p_e_c_i_a_l is calculated at the time the device
     is first made available for swapping.

RREETTUURRNN VVAALLUUEESS
     If an error has occurred, a value of -1 is returned and _e_r_r_n_o is set to
     indicate the error.

EERRRROORRSS
     SSwwaappoonn() succeeds unless:

     [ENOTDIR]     A component of the path prefix is not a directory.

     [EINVAL]      The pathname contains a character with the high-order bit
                   set.

     [ENAMETOOLONG]
                   A component of a pathname exceeded 255 characters, or an
                   entire path name exceeded 1023 characters.

     [ENOENT]      The named device does not exist.

     [EACCES]      Search permission is denied for a component of the path
                   prefix.

     [ELOOP]       Too many symbolic links were encountered in translating the
                   pathname.

     [EPERM]       The caller is not the super-user.

     [ENOTBLK]     _S_p_e_c_i_a_l is not a block device.

     [EBUSY]       The device specified by _s_p_e_c_i_a_l has already been made
                   available for swapping

     [EINVAL]      The device configured by _s_p_e_c_i_a_l was not configured into
                   the system as a swap device.

     [ENXIO]       The major device number of _s_p_e_c_i_a_l is out of range (this
                   indicates no device driver exists for the associated hard-
                   ware).

     [EIO]         An I/O error occurred while opening the swap device.

     [EFAULT]      _S_p_e_c_i_a_l points outside the process's allocated address
                   space.

SSEEEE AALLSSOO
     swapon(8),  config(8)

BBUUGGSS
     There is no way to stop swapping on a disk so that the pack may be dis-
     mounted.

     This call will be upgraded in future versions of the system.

HHIISSTTOORRYY
     The sswwaappoonn function call appeared in 4.0BSD.

4th Berkeley Distribution        June 4, 1993                                2