.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992 .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified by Michael Haardt .\" Modified 1993-07-24 by Rik Faith .\" Modified 1995-07-22 by Michael Chastain .\" Modified 1995-07-23 by aeb .\" Modified 1996-10-22 by Eric S. Raymond .\" Modified 1998-09-08 by aeb .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2004-10-10 by aeb .\" 2004-12-14 mtk, Anand Kumria: added new errors .\" 2007-06-22 Ivana Varekova , mtk .\" Update text describing limit on number of swap files. .\" 2021-01-17 Alex Baranowski .\" Update information about available swap files decreased by .\" CONFIG_DEVICE_PRIVATE option. .\" .\" FIXME Linux 3.11 added SWAP_FLAG_DISCARD_ONCE and SWAP_FLAG_DISCARD_PAGES .\" commit dcf6b7ddd7df8965727746f89c59229b23180e5a .\" Author: Rafael Aquini .\" Date: Wed Jul 3 15:02:46 2013 -0700 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH swapon 2 "30 mars 2023" "Pages du manuel de Linux 6.05.01" .SH NOM swapon, swapoff \- Activer/désactiver un fichier ou un périphérique de swap .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint swapon(const char *\fP\fIpath\fP\fB, int \fP\fIswapflags\fP\fB);\fP \fBint swapoff(const char *\fP\fIpath\fP\fB);\fP .fi .SH DESCRIPTION \fBswapon\fP() active le swap sur le fichier ou le périphérique bloc indiqué dans \fIpath\fP. \fBswapoff\fP() arrête le swap sur le fichier ou le périphérique bloc indiqué dans \fIpath\fP. .PP Si l'attribut \fBSWAP_FLAG_PREFER\fP est indiqué dans le paramètre \fIswapflags\fP de \fBswapon\fP(), la nouvelle zone de swap disposera d'une priorité plus élevée que la zone de swap par défaut. La priorité est codée ainsi\ : .PP .in +4n .EX \fI(prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK\fP .EE .in .PP Si l'attribut \fBSWAP_FLAG_DISCARD\fP est indiqué dans le paramètre \fIswapflags\fP de \fBswapon\fP(), les pages d'échange libérées seront supprimées avant d'être réutilisées, si le périphérique d'échange prend en charge l'opération de mise au rebut («\ discard\ ») ou d'élagage («\ trim\ »). Ceci peut améliorer les performances sur certains périphériques SSD («\ Solid State Devices\ »), mais souvent cela n'a pas d'influcence. Consultez aussi la section NOTES. .PP Cette fonction ne peut être appelée que par un processus privilégié (qui a la capacité \fBCAP_SYS_ADMIN\fP. .SS Priorité Chaque zone de swap a une priorité, haute ou basse. La priorité par défaut est basse. Parmi les zones de basses priorités, les nouvelles zones sont toujours affectées d'une priorité inférieure à celle des zones précédentes. .PP Toutes les priorités définies avec l'argument \fIswapflags\fP sont plus élevées que la priorité par défaut. Elles peuvent prendre n'importe quelle valeur positive ou nulle choisie par l'appelant. Plus la valeur est haute, plus la priorité est élevée. .PP Les pages de swap sont allouées dans les zones par ordre décroissant de priorité. Pour des zones de priorité différentes, la plus haute sera toujours remplie entièrement avant d'utiliser la zone de priorité plus faible. Si deux ou plus de zones ont la même priorité, et qu'il s'agit de la plus haute priorité disponible, les pages sont allouées en utilisant un algorithme Round\-Robin entre elles. .PP Sur Linux 1.3.6, le noyau suit généralement ces règles, mais il y a parfois des exceptions. .SH "VALEUR RENVOYÉE" En cas de succès, zéro est renvoyé. En cas d'erreur, \fB\-1\fP est renvoyé et \fIerrno\fP est définie pour préciser l'erreur. .SH ERREURS .TP \fBEBUSY\fP (pour \fBswapon\fP()) Le chemin \fIpath\fP est déjà utilisé comme espace d'échange. .TP \fBEINVAL\fP Le fichier \fIpath\fP existe, mais ne référence ni un fichier ordinaire, ni un périphérique bloc. .TP \fBEINVAL\fP (\fBswapon\fP()) Le fichier indiqué ne contient pas de signature de swap correcte ou réside sur un système de fichiers en mémoire comme \fBtmpfs\fP(5). .TP \fBEINVAL\fP (depuis Linux\ 3.4) (\fBswapon\fP()) \fIswapflags\fP contient un drapeau invalide. .TP \fBEINVAL\fP (\fBswapoff\fP()) Le chemin \fIpath\fP n'est pas actuellement un espace d'échange. .TP \fBENFILE\fP La limite du nombre total de fichiers ouverts pour le système entier a été atteinte. .TP \fBENOENT\fP \fIpath\fP n'existe pas. .TP \fBENOMEM\fP Pas assez de mémoire pour démarrer le swapping. .TP \fBEPERM\fP L'appelant n'a pas la capacité \fBCAP_SYS_ADMIN\fP, ou le nombre maximal de fichiers d'échange est atteint\ ; voir la section NOTES. .SH STANDARDS Linux. .SH HISTORIQUE L'argument \fIswapflags\fP a été introduit dans Linux\ 1.3.2. .SH NOTES La partition ou le fichier doivent être préparés par \fBmkswap\fP(8). .PP Le nombre de fichiers d'échange qui peuvent être utilisés est limité par la constante \fBMAX_SWAPFILES\fP du noyau. Avant Linux\ 2.4.10, \fBMAX_SWAPFILES\fP valait 8\ ; depuis Linux\ 2.4.10, il vaut\ 32. Depuis Linux\ 2.6.18, cette limite est décrémentée de\ 2 (et vaut donc 30) si le noyau est compilé avec \fBCONFIG_MIGRATION\fP (qui réserve deux entrées de table de swap pour les l'option possibilités de migration offertes par \fBmbind\fP(2) et \fBmigrate_pages\fP(2)). Depuis Linux 2.6.32, la limite est encore décrémentée de\ 1 si le noyau est compilé avec l'option \fBCONFIG_MEMORY_FAILURE\fP. Depuis Linux\ 5.14, la limite encore décrémentée de\ 4 si le noyau est compilé avec l'option \fBCONFIG_DEVICE_PRIVATE\fP. .PP .\" To be precise: 2.6.35.5 La suppression de pages d'échange a été introduite dans Linux\ 2.6.29, puis fut conditionnée à l'attribut \fBSWAP_FLAG_DISCARD\fP dans Linux\ 2.6.36, qui supprime toujours la zone d'échange entière quand \fBswapon\fP() est appelée, même si ce bit d'attribut n'est pas mis. .SH "VOIR AUSSI" \fBmkswap\fP(8), \fBswapoff\fP(8), \fBswapon\fP(8) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .