Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
utilisateurs:lagrenouille:tutos:commande-udisksctl [19/05/2023 00:43] lagrenouille [Utilisation] |
utilisateurs:lagrenouille:tutos:commande-udisksctl [19/06/2023 19:36] (Version actuelle) lagrenouille [udisksctl] |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
====== udisksctl ====== | ====== udisksctl ====== | ||
- | * Création par : [[user>lagrenouille]] | + | * Création par : [[user>lagrenouille]] ..le 12/05/2023 |
* Objet : du tuto : la commande udisksctl | * Objet : du tuto : la commande udisksctl | ||
* Niveau requis : FIXME {{tag>débutant avisé}} | * Niveau requis : FIXME {{tag>débutant avisé}} | ||
* Commentaires : //Contexte d'utilisation du sujet du tuto. // FIXME | * Commentaires : //Contexte d'utilisation du sujet du tuto. // FIXME | ||
* Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | ||
- | * Suivi: {{tag>à-compléter}} | + | * Suivi: {{tag>à-tester}} |
===== Introduction ===== | ===== Introduction ===== | ||
udisksctl est un programme en ligne de commande utilisé pour interagir avec le processus démon udisksd | udisksctl est un programme en ligne de commande utilisé pour interagir avec le processus démon udisksd | ||
+ | |||
udisksctl Affiche des informations de haut niveau sur les unités de disque et les périphériques de bloc : | udisksctl Affiche des informations de haut niveau sur les unités de disque et les périphériques de bloc : | ||
+ | |||
Utilisez "udisksctl COMMAND --help" pour obtenir de l'aide sur chaque commande. | Utilisez "udisksctl COMMAND --help" pour obtenir de l'aide sur chaque commande. | ||
+ | COMMANDS | ||
+ | status | ||
+ | |||
+ | Shows high-level information about disk drives and block devices. | ||
+ | |||
+ | Affiche des informations de haut niveau sur les lecteurs de disque et les périphériques de bloc. | ||
+ | |||
+ | info | ||
+ | |||
+ | Shows detailed information about OBJECT or DEVICE. | ||
+ | |||
+ | Affiche des informations détaillées sur OBJECT ou DEVICE . | ||
+ | |||
+ | mount | ||
+ | |||
+ | Mounts a device. The device will be mounted in a subdirectory in the /media hierarchy | ||
+ | - upon successful completion, the mount point will be printed to standard output. | ||
+ | |||
+ | The device will be mounted with a safe set of default options. You can influence the options passed to the mount(8) command with --options. Note that only safe options are allowed - requests with inherently unsafe options such as suid or dev that would allow the caller to gain additional privileges, are rejected. | ||
+ | |||
+ | Monte un appareil. Le périphérique sera monté dans un sous-répertoire de la hiérarchie /media, en cas de réussite, le point de montage sera imprimé sur la sortie standard. | ||
+ | L'appareil sera monté avec un ensemble sûr d'options par défaut. Vous pouvez influencer le | ||
+ | options passées à la commande mount (8) avec --options . Notez que seules les options sûres sont autorisé - requêtes avec des options intrinsèquement dangereuses telles que suid ou dev qui permettraient 'appelant pour obtenir des privilèges supplémentaires, sont rejetées. | ||
+ | |||
+ | |||
+ | unmount | ||
+ | |||
+ | Unmounts a device. This only works if the device is mounted. The option --force can be | ||
+ | used to request that the device is unmounted even if active references exists. | ||
+ | |||
+ | Démonte un périphérique. Cela ne fonctionne que si l'appareil est monté. L'option --force peut être | ||
+ | utilisé pour demander que l'appareil soit démonté même si des références actives existent. | ||
+ | |||
+ | |||
+ | |||
+ | unlock | ||
+ | |||
+ | Unlocks an encrypted device. The passphrase will be requested from the controlling | ||
+ | terminal and upon successful completion, the cleartext device will be printed to | ||
+ | standard output. | ||
+ | |||
+ | Déverrouille un appareil crypté. La phrase de passe sera demandée au contrôleur | ||
+ | terminal et en cas de réussite, le périphérique de texte en clair sera imprimé sur sortie standard | ||
+ | |||
+ | lock | ||
+ | |||
+ | Locks a device. This only works if the device is a cleartext device backed by a cryptotext device. | ||
+ | |||
+ | Verrouille un appareil. Cela ne fonctionne que si l'appareil est un appareil en texte clair soutenu par un périphérique de cryptotexte. | ||
+ | |||
+ | |||
+ | loop-setup | ||
+ | |||
+ | Sets up a loop device backed by FILE. | ||
+ | |||
+ | Configure un périphérique de boucle soutenu par FILE . | ||
+ | |||
+ | |||
+ | loop-delete | ||
+ | |||
+ | Tears down a loop device. | ||
+ | |||
+ | Démonte un périphérique en boucle. | ||
+ | |||
+ | power-off | ||
+ | Arranges for the drive to be safely removed and powered off. On the OS side this | ||
+ | includes ensuring that no process is using the drive, then requesting that in-flight | ||
+ | buffers and caches are committed to stable storage. The exact steps for powering off | ||
+ | the drive depends on the drive itself and the interconnect used. For drives connected | ||
+ | through USB, the effect is that the USB device will be deconfigured followed by | ||
+ | disabling the upstream hub port it is connected to. | ||
+ | |||
+ | Note that as some physical devices contain multiple drives (for example 4-in-1 flash | ||
+ | card reader USB devices) powering off one drive may affect other drives. As such there | ||
+ | are not a lot of guarantees associated with performing this action. Usually the effect | ||
+ | is that the drive disappears as if it was unplugged. | ||
+ | |||
+ | |||
+ | S'arrange pour que le disque soit retiré et éteint en toute sécurité. Du côté du système d'exploitation, cela | ||
+ | comprend la vérification qu'aucun processus n'utilise le lecteur, puis la demande en cours | ||
+ | |||
+ | les tampons et les caches sont dédiés à un stockage stable. Les étapes exactes pour éteindre | ||
+ | le lecteur dépend du lecteur lui-même et de l'interconnexion utilisée. | ||
+ | |||
+ | Pour les lecteurs connectés | ||
+ | via USB, l'effet est que le périphérique USB sera déconfiguré suivi de | ||
+ | désactivant le port du concentrateur en amont auquel il est connecté. | ||
+ | |||
+ | Notez que certains périphériques physiques contiennent plusieurs disques (par exemple, flash 4 en 1 | ||
+ | lecteur de carte périphériques USB) la mise hors tension d'un lecteur peut affecter d'autres lecteurs. Comme tel là | ||
+ | il n'y a pas beaucoup de garanties associées à l'exécution de cette action. Généralement l'effet | ||
+ | est que le lecteur disparaît comme s'il était débranché. | ||
+ | |||
+ | |||
+ | |||
+ | smart-simulate | ||
+ | |||
+ | Sets SMART data from the libatasmart blob given by FILE - see | ||
+ | /usr/share/doc/libatasmart-devel-VERSION/ for blobs shipped with libatasmart. This is | ||
+ | a debugging feature used to check that applications act correctly when a disk is | ||
+ | failing. | ||
+ | |||
+ | Définit les données SMART du blob libatasmart donné par FILE - voir | ||
+ | /usr/share/doc/libatasmart-devel-VERSION/ pour les blobs livrés avec libatasmart. C'est | ||
+ | une fonctionnalité de débogage utilisée pour vérifier que les applications fonctionnent correctement lorsqu'un disque est | ||
+ | échouer. | ||
+ | |||
+ | monitor | ||
+ | |||
+ | Monitors the daemon for events. Surveille le démon pour les événements. | ||
+ | |||
+ | dump | ||
+ | |||
+ | Prints the current state of the daemon. Affiche l'état actuel du démon. | ||
+ | |||
+ | help | ||
+ | |||
+ | Prints help and exit. affiche l'aide et la sortie. | ||
+ | |||
+ | Ce programme ne suppose pas que l'appelant est le super utilisateur - il est destiné à être utilisé | ||
+ | par des utilisateurs non privilégiés et les autorisations sont vérifiées par le démon udisks à l'aide de polkit (8). | ||
+ | De plus, ce programme n'est pas destiné à être utilisé par des scripts ou d'autres programmes - | ||
+ | les options/commandes peuvent changer de manière incompatible à l'avenir, même en maintenance | ||
+ | versions. Voir la section "API STABILITY" de udisks (8) pour plus d'informations. | ||
+ | |||
+ | udisksctl est livré avec un script de complétion bash pour compléter les commandes, les objets et les périphériques de blocage | ||
+ | et quelques options. | ||
+ | |||
+ | udisksd - Le démon système udisks | ||
+ | |||
+ | udisksd [ --help ] [ --replace ] [ --no-debug ] [ --no-sigint ] | ||
+ | |||
+ | Le programme udisksd fournit le nom org.freedesktop.UDisks2 sur le bus de messages système. | ||
+ | |||
+ | Les utilisateurs ou les administrateurs ne devraient jamais avoir besoin de démarrer ce démon car il sera automatiquement | ||
+ | |||
+ | démarré par dbus-daemon (1) ou systemd (1) chaque fois qu'une application tente d'accéder à son D-Bus interfaces. | ||
+ | |||
+ | Voir la page de manuel udisks (8) pour plus d'informations. | ||
+ | |||
+ | OPTIONS | ||
+ | |||
+ | --help | ||
+ | - | ||
+ | Show help options. | ||
+ | |||
+ | |||
+ | --replace | ||
+ | - | ||
+ | Replace existing daemon. | ||
+ | |||
+ | --no-debug | ||
+ | - | ||
+ | Do not print debug or informational messages on stdout/stderr. | ||
+ | |||
+ | --no-sigint | ||
+ | - | ||
+ | Do not handle SIGINT for controlled shutdown. | ||
+ | |||
+ | |||
+ | |||
===== Utilisation ===== | ===== Utilisation ===== | ||
Ligne 25: | Ligne 188: | ||
-b, --block-device Block device to get information about | -b, --block-device Block device to get information about | ||
-d, --drive Drive to get information about</code> | -d, --drive Drive to get information about</code> | ||
+ | |||
+ | <code root>udisksctl info --block-device /dev/sda | ||
+ | /org/freedesktop/UDisks2/block_devices/sda: | ||
+ | org.freedesktop.UDisks2.Block: | ||
+ | Configuration: [] | ||
+ | CryptoBackingDevice: '/' | ||
+ | Device: /dev/sda | ||
+ | DeviceNumber: 2048 | ||
+ | Drive: '/org/freedesktop/UDisks2/drives/WDC_WD20EZAZ_00GGJB0_WD_WXR1AC8K4JA9' | ||
+ | HintAuto: false | ||
+ | HintIconName: | ||
+ | HintIgnore: false | ||
+ | HintName: | ||
+ | HintPartitionable: true | ||
+ | HintSymbolicIconName: | ||
+ | HintSystem: true | ||
+ | Id: by-id-ata-WDC_WD20EZAZ-00GGJB0_WD-WXR1AC8K4JA9 | ||
+ | IdLabel: | ||
+ | IdType: | ||
+ | IdUUID: | ||
+ | IdUsage: | ||
+ | IdVersion: | ||
+ | MDRaid: '/' | ||
+ | MDRaidMember: '/' | ||
+ | PreferredDevice: /dev/sda | ||
+ | ReadOnly: false | ||
+ | Size: 2000398934016 | ||
+ | Symlinks: /dev/disk/by-id/ata-WDC_WD20EZAZ-00GGJB0_WD-WXR1AC8K4JA9 | ||
+ | /dev/disk/by-id/wwn-0x50014ee2bb7b0427 | ||
+ | /dev/disk/by-path/pci-0000:00:17.0-ata-2 | ||
+ | /dev/disk/by-path/pci-0000:00:17.0-ata-2.0 | ||
+ | UserspaceMountOptions: | ||
+ | org.freedesktop.UDisks2.PartitionTable: | ||
+ | Partitions: /org/freedesktop/UDisks2/block_devices/sda1 | ||
+ | Type: dos | ||
+ | root@arthur:~# statut udisksctl | ||
+ | -bash: statut : commande introuvable | ||
+ | root@arthur:~# udisksctl info | ||
+ | Utilisation : | ||
+ | udisksctl info [OPTION…] | ||
+ | |||
+ | Show information about an object. | ||
+ | |||
+ | Options : | ||
+ | -p, --object-path Object to get information about | ||
+ | -b, --block-device Block device to get information about | ||
+ | -d, --drive Drive to get information about</code> | ||
+ | |||
+ | |||
<code root>udisksctl help | <code root>udisksctl help |