MKSWAP(8)                  Administration Systeme                    MKSWAP(8)

NOM
       mkswap - Creer une zone d'echange (swap) Linux

SYNOPSIS
       mkswap [options] peripherique [blocs]

       mkswap [options] --size taille --file fichier

DESCRIPTION
       mkswap cree une zone d'echange Linux sur un peripherique ou dans un
       fichier.

       Le parametre peripherique est normalement une partition du disque dur
       (/dev/sdb7 par exemple) mais peut aussi etre un fichier. Le noyau Linux
       ne regarde pas les identifiants de partition, mais beaucoup de scripts
       d'installation supposeront que les partitions de type 82 en hexadecimal
       (LINUX_SWAP) sont, par defaut, des partitions d'echange. (Attention :
       Solaris utilise aussi le type 82 ; prenez garde de ne pas supprimer les
       partitions Solaris.)

       Le parametre blocs est superflu mais il est conserve pour des raisons
       de compatibilite ascendante. Il indique la taille desiree de la zone
       d'echange par blocs de 1024 octets. mkswap utilisera la totalite de la
       partition ou du fichier si la taille est omise. L'indiquer est
       imprudent -- une coquille pourrait detruire le disque.

       Apres avoir cree la zone d'echange, vous aurez besoin de la commande
       swapon(8) pour l'utiliser. Habituellement les zones d'echange sont
       indiquees dans le fichier /etc/fstab afin qu'elles puissent etre
       utilisees au demarrage par la commande swapon -a dans les scripts de
       demarrage.

AVERTISSEMENT
       L'en-tete de la zone d'echange ne modifie pas le premier bloc. Un
       chargeur de demarrage ou une etiquette de disque peut y etre place,
       mais ce n'est pas une configuration recommandee. La configuration
       recommandee est d'utiliser une partition separee pour la zone
       d'echange.

       mkswap, comme beaucoup d'autres outils du type mkfs, efface le premier
       bloc de la partition pour rendre les anciens systemes de fichiers
       invisibles.

       Cependant, mkswap refuse de supprimer le premier bloc d'un peripherique
       avec une etiquette de disque (SUN, BSD, etc.).

OPTIONS
       -c, --check
           Verifier le peripherique (si c'est un peripherique bloc) pour
           decouvrir les blocs corrompus avant de creer une zone d'echange. Si
           des blocs corrompus sont trouves, leur nombre est affiche.

       -F, --file
           Creer un fichier d'echange avec les permissions de fichier
           appropriees et remplire les blocs sur le disque.

       -f, --force
           Continuer meme si la commande est stupide. Cela permet de creer une
           zone d'echange plus grande que la taille du fichier ou de la
           partition dans laquelle elle reside.

           Ainsi, sans cette option, mkswap refusera d'effacer le premier bloc
           d'un peripherique avec une table de partitions.

       -q, --quiet
           Supprimer la sortie et les messages d'avertissements.

       -L, --label etiquette
           Indiquer une etiquette de peripherique pour permettre l'utilisation
           de swapon(8) avec cette etiquette.

       --lock[=mode]
           Utiliser un verrou BSD exclusif pour le peripherique ou le fichier
           vise. L'argument facultatif mode peut etre yes, no (ou 1 et 0) ou
           nonblock. Si cet argument est absent, sa valeur par defaut est yes.
           Cette option ecrase la variable d'environnement $LOCK_BLOCK_DEVICE.
           Le comportement par defaut est de n'utiliser aucun verrou, mais
           cela est recommande pour eviter des collisions avec
           systemd-udevd(8) ou d'autres outils.

       -p, --pagesize taille
           Indiquer la taille de page (en octet) a utiliser. Cette option est
           normalement inutile, mkswap lit la taille depuis le noyau.

       -U, --uuid UUID
           Specifier le UUID a utiliser. Par defaut, un UUID est genere. Le
           format du UUID est des series de chiffres hexadecimaux separes par
           des tirets, comme ceci :
           << c1b9d5a2-f162-11cf-9ece-0020afc76f16 >>. Le parametre UUID peut
           aussi etre l'une de ces valeurs :

           clear
               effacer le UUID du systeme de fichiers

           random
               generer un nouveau UUID aleatoire

           time
               generer un nouveau UUID base sur l'heure

       -e, --endianness ENDIANNESS
           Specify the ENDIANNESS to use, valid arguments are native, little
           or big. The default is native.

       -o, --offset position
           Specifie l'offset ou ecrire la zone d'echange.

       -s, --size taille
           Specifie la taille du fichier d'echange cree. La taille peut etre
           suivie des suffixes multiplicatifs KiB (=1024), MiB (=1024*1024) et
           ainsi de suite pour GiB, TiB, PiB, EiB, ZiB et YiB (la partie
           << iB >> est facultative, par exemple << K >> est identique a
           << KiB >>). Si le fichier existe et est plus grand que la taille,
           il sera tronque a cette taille. Cette option n'a de sens qu'avec
           --file.

       -v, --swapversion 1
           Indiquer la version de l'espace d'echange. Cette option ne sert
           actuellement a rien car l'ancienne option -v 0 est devenue obsolete
           et que seule -v 1 est prise en charge. Le noyau ne prend plus en
           charge le format v0 d'espace d'echange depuis la version 2.5.22
           (juin 2002). La nouvelle version v1 est prise en charge depuis le
           noyau 2.1.117 (aout 1998).

       --verbose
           Execution verbeuse. Avec cette option, mkswap sort plus de details
           a propos des problemes detectes durant la preparation de la zone
           d'echange.

       -h, --help
           Afficher l'aide-memoire puis quitter.

       -V, --version
           Afficher la version et quitter.

ENVIRONNEMENT
       LIBBLKID_DEBUG=all
           Activer la sortie de debogage de libblkid.

       LOCK_BLOCK_DEVICE=<mode>
           Utiliser un verrou exclusif BSD. Le mode est << 1 >> ou << 0 >>.
           Consulter --lock pour davantage de details.

NOTES
       La taille utile maximale d'une zone d'echange depend de l'architecture
       et de la version du noyau.

       Le nombre maximal de pages qu'il est possible d'adresser avec l'en-tete
       de la zone d'echange est 4 294 967 295 (entier de 32 bits non signe).
       L'espace restant dans le peripherique d'echange est ignore.

       Actuellement, Linux autorise 32 zones d'echange. Les zones en cours
       d'utilisation sont visibles dans le fichier /proc/swaps.

       mkswap refuse les zones de taille inferieure a 10 pages.

       Si vous ne connaissez pas la taille de page utilisee par votre machine,
       vous pouvez la decouvrir avec getconf PAGESIZE.

       En plus de mkswap --file, il est aussi possible de creer un fichier
       d'echange manuellement avant de l'initialiser avec mkswap, par exemple
       en utilisant une commande comme

       Depuis la version 2.41, mkswap --file defini l'attribut nocow pour les
       fichiers nouvellement crees afin de supporter les fichiers d'echange
       sur Btrfs.

           # dd if=/dev/zero of=fichier_echange bs=1MiB count=$((8*1024))

       pour creer un fichier d'echange de 8 GiB.

       Dans un tel cas, veuillez lire les notes dans swapon(8) sur les
       restrictions d'utilisation de fichier d'echange (trous, preallocation
       et problemes de copie sur ecriture).

VOIR AUSSI
       fdisk(8), swapon(8)

SIGNALER DES BOGUES
       Pour signaler un bogue, utilisez le gestionnaire de bogues
       <https://github.com/util-linux/util-linux/issues>.

DISPONIBILITE
       La commande mkswap fait partie du paquet util-linux, elle est
       disponible sur l'archive du noyau Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.41                   2025-03-29                         MKSWAP(8)