unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



swapon(2)							    swapon(2)



NAME
  swapon - Adds	a swap device for interleaved paging and swapping

SYNOPSIS

  swapon(
	  char *path,
	  int flags,
	  int lowat,
	  int hiwat );

PARAMETERS

  path Specifies the block special device to be	made available.

  flags
       Specifies a flag.  Only the MS_PREFER flag is currently supported, and
       it causes the specified path to be the preferred	paging device.
       (Ignored	on Tru64 UNIX.)

  lowat
       Specifies the low water mark.  (Ignored on Tru64	UNIX.)

  hiwat
       Specifies the high water	mark.  (Ignored	on Tru64 UNIX.)

DESCRIPTION

  The swapon() function	makes a	block special device available to the system
  for allocation of paging and swapping	space.	(The operating system does
  not currently	support	paging and swapping to a normal	file.  All swapping
  and pages areas must be block	special	devices.)

  The calling process must have	superuser privilege to call the	swapon()
  function.

RETURN VALUES

  Upon successful completion, the swapon() function returns a value of 0
  (zero).  If an error has occurred, -1	is returned and	errno is set to	indi-
  cate the error.

ERRORS

  If the swapon() function fails, errno	may be set to one of the following
  values:

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

  [EINVAL]  The	pathname contains a character with the high-order bit set,
	    the	device was not specified, the device configured	by the path
	    parameter was not configured into the system as a swap device, or
	    the	device does not	allow paging.

  [ENAMETOOLONG]
	    A component	of a pathname exceeded NAME_MAX	characters, or an
	    entire pathname exceeded PATH_MAX 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	path-
	    name.

  [EPERM]   The	caller does not	have appropriate privilege.

  [EBUSY]   The	device specified by the	path parameter has already been	made
	    available for swapping.

  [ENXIO]   The	major device number of the path	parameter is out of range
	    (this indicates no device driver exists for	the associated
	    hardware).

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

  [EFAULT]  The	path parameter points outside the process' allocated address
	    space.

  [EROFS]   An attempt was made	to activate a paging file on a read-only file
	    system.

RELATED	INFORMATION

  Commands: swapon(8), config(8)