swapon(2)
_________________________________________________________________
swapon System Call
Add a swap device for interleaved paging/swapping.
_________________________________________________________________
SYNTAX
int swapon (special)
char * special;
PARAMETERS
special Name of the block device to page on.
DESCRIPTION
Swapon makes the block device <special> available to the system
for allocation for paging and swapping. The names of potentially
available devices are known to the system and defined at system
configuration time. The size of the swap area on <special> is
also based on a value specified in the system file at
configuration time.
ACCESS CONTROL
The effective user id of the calling process must be superuser.
RETURN VALUE
0 The given device was successfully put into service
as a paging area.
-1 The given device could not be put into service as
a paging area.
EXCEPTIONS
Errno will be set to the one of following values if the
corresponding condition exists:
ENOENT The device <special> is unknown.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
swapon(2)
EPERM The calling process is not the superuser.
ENOSPC The paging area could not be set up because the
system already has the maximum number of paging
areas in use.
ENODEV The paging area could not be set up because its
size is bigger than the maximum allowable size for
a paging area.
ENOTBLK The given device name does not specify a block
special file.
EBUSY The given device is already in use.
ENOENT The file the pathname resolved to does not exist.
ENOENT A non-terminal component of the pathname does not
exist.
ENOTDIR A non-terminal component of the pathname was not a
directory or symbolic link.
ENAMETOOLONG The pathname exceeds the length limit for
pathnames.
ENAMETOOLONG A component of the pathname exceeds the length
limit for filenames.
ENOMEM There are not enough system resources to resolve
the pathname or to expand a symbolic link.
ELOOP The number of symbolic links encountered during
pathname resolution exceeded MAXSYMLINKS. A
symbolic link cycle is suspected.
EPERM The pathname contains a character not in the
allowed character set.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
swapon(2)
EFAULT The pathname does not completely reside in the
process's address space or the pathname does not
terminate in the process's address space.
SEE ALSO
The related manual sections: None.
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)