| .\" Copyright (c) 1980, 1991 Regents of the University of California. |
| .\" All rights reserved. |
| .\" |
| .\" Redistribution and use in source and binary forms, with or without |
| .\" modification, are permitted provided that the following conditions |
| .\" are met: |
| .\" 1. Redistributions of source code must retain the above copyright |
| .\" notice, this list of conditions and the following disclaimer. |
| .\" 2. Redistributions in binary form must reproduce the above copyright |
| .\" notice, this list of conditions and the following disclaimer in the |
| .\" documentation and/or other materials provided with the distribution. |
| .\" 3. All advertising materials mentioning features or use of this software |
| .\" must display the following acknowledgement: |
| .\" This product includes software developed by the University of |
| .\" California, Berkeley and its contributors. |
| .\" 4. Neither the name of the University nor the names of its contributors |
| .\" may be used to endorse or promote products derived from this software |
| .\" without specific prior written permission. |
| .\" |
| .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
| .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE |
| .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
| .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY |
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| .\" SUCH DAMAGE. |
| .\" |
| .\" @(#)swapon.8 6.3 (Berkeley) 3/16/91 |
| .\" |
| .\" Sun Dec 27 12:31:30 1992: Modified by faith@cs.unc.edu |
| .\" Sat Mar 6 20:46:02 1993: Modified by faith@cs.unc.edu |
| .\" Sat Oct 9 09:35:30 1993: Converted to man format by faith@cs.unc.edu |
| .\" Sat Nov 27 20:22:42 1993: Updated authorship information, faith@cs.unc.edu |
| .\" Mon Sep 25 14:12:38 1995: Added -v and -p information |
| .\" Tue Apr 30 03:32:07 1996: Added some text from A. Koppenhoefer |
| .\" |
| .TH SWAPON 8 "25 September 1995" "Linux 1.x" "Linux Programmer's Manual" |
| .SH NAME |
| swapon, swapoff \- enable/disable devices and files for paging and swapping |
| .SH SYNOPSIS |
| .B /sbin/swapon [\-h \-V] |
| .br |
| .B /sbin/swapon \-a [\-v] |
| .br |
| .BI "/sbin/swapon [\-v] [\-p " "priority" "] " " specialfile " ... |
| .br |
| .B /sbin/swapon [\-s] |
| .br |
| .B /sbin/swapoff [\-h \-V] |
| .br |
| .B /sbin/swapoff \-a |
| .br |
| .BI /sbin/swapoff " specialfile " ... |
| .SH DESCRIPTION |
| .B Swapon |
| is used to specify devices on which paging and swapping are to take place. |
| Calls to |
| .B swapon |
| normally occur in the system multi-user initialization file |
| .I /etc/rc |
| making all swap devices available, so that the paging and swapping activity |
| is interleaved across several devices and files. |
| |
| Normally, the first form is used: |
| .TP |
| .B \-h |
| Provide help |
| .TP |
| .B \-V |
| Display version |
| .TP |
| .B \-s |
| Display swap usage summary by device |
| .TP |
| .B \-a |
| All devices marked as ``sw'' swap devices in |
| .I /etc/fstab |
| are made available. |
| .TP |
| .BI \-p " priority" |
| Specify priority for |
| .BR swapon . |
| This option is only available if |
| .B swapon |
| was compiled under and is used under a 1.3.2 or later kernel. |
| .I priority |
| is a value between 0 and 32767. See |
| .BR swapon (2) |
| for a full description of swap priorities. Add |
| .BI pri= value |
| to the option field of |
| .I /etc/fstab |
| for use with |
| .BR "swapon -a" . |
| .PP |
| .B Swapoff |
| disables swapping on the specified devices and files, or on all swap |
| entries in |
| .I /etc/fstab |
| when the |
| .B \-a |
| flag is given. |
| .SH SEE ALSO |
| .BR swapon "(2), " swapoff "(2), " fstab "(5), " init "(8), " mkswap (8), |
| .BR rc "(8), " mount (8) |
| .SH FILES |
| .I /dev/hd?? |
| standard paging devices |
| .br |
| .I /dev/sd?? |
| standard (SCSI) paging devices |
| .br |
| .I /etc/fstab |
| ascii filesystem description table |
| .SH HISTORY |
| The |
| .B swapon |
| command appeared in 4.0BSD. |
| .SH AUTHORS |
| See the Linux |
| .BR mount (8) |
| man page for a complete author list. Primary contributors include Doug |
| Quale, H. J. Lu, Rick Sladkey, and Stephen Tweedie. |
