bionic (2) umount2.2.gz

Provided by: manpages-it_3.73-2_all bug

NOME

       umount, umount2 - smonta i filesystem

SINTASSI

       #include <sys/mount.h>

       int umount(const char *target);

       int umount2(const char *target, int opzioni);

DESCRIZIONE

       umount() e umount2() rimuovono il filesystem (più alto) montato su target.

       Sono necessari privilegi appropriati (Linux: capacità CAP_SYS_ADMIN) per smontare i filesystem.

       A  partire  da Linux 2.1.116 è stata aggiunta la chiamata di sistema umount2() che, come umount(), smonta
       un target, ma permette opzioni aggiuntive che controllano il comportamento dell'operazione:

       MNT_FORCE (a partire da Linux 2.1.116)
              Forza lo smontaggio anche se occupato.  Questo può causare una perdita di dati.  (solo per i mount
              NFS).

       MNT_DETACH (a partire da Linux 2.4.11)
              Esegue  uno  smontaggio  lento:  rende  il  punto di mount non disponibile per i nuovi accessi, ed
              esegue effettivamente lo smontaggio quando il punto di mount smette di essere occupato.

       MNT_EXPIRE (a partire da Linux 2.6.8)
              Marca il punto di mount come scaduto.  Se un punto di mount non è attualmente in uso,  allora  una
              chiamata  iniziale  a umount2() con questa opzione fallisce con l'errore EAGAIN, ma marca il punto
              di mount come scaduto.  Il punto di mount rimane scaduto  fino  a  quando  non  vi  accede  nessun
              processo.   Una  seconda  chiamata  umount2()  che  specifica  MNT_EXPIRE smonta un punto di mount
              scaduto.  Questa opzione non può essere specificato con MNT_FORCE o con MNT_DETACH.

       UMOUNT_NOFOLLOW (a partire da Linux 2.6.34)
              Non elimina il riferimento a target se è un collegamento simbolico.  Questa  opzione  permette  di
              evitare  problemi  di  sicurezza  in  programmi  set-user-ID-root  che  consentono  a utenti senza
              privilegi di smontare i filesystem.

VALORE RESTITUITO

       In caso di successo viene restituito zero.  In caso di  errore  viene  restituito  -1  ,  e  errno  viene
       impostato di conseguenza.

ERRORI

       I  valori  di  errore  indicati  di  seguito  sono causati da errori indipendenti dal tipo di filesystem.
       Ciascun tipo di filesystem può avere i propri errori speciali e il suo comportamento speciale.  Vedere il
       codice sorgente del kernel per dettagli.

       EAGAIN Una  chiamata  a  umount2()  che  specifica  MNT_EXPIRE  ha marcato con successo un filesystem non
              occupato come scaduto.

       EBUSY  target non può essere smontato in quanto occupato.

       EFAULT target punta fuori dallo spazio di indirizzamento dell'utente.

       EINVAL target non è un punto di mount.

       EINVAL umount2() è stato chiamato con MNT_EXPIRE e con uno fra MNT_DETACH o MNT_FORCE.

       EINVAL (a partire da Linux 2.6.34)
              umount2() è stato cchiamato con un valore di opzione non valido in flags.

       ENAMETOOLONG
              Un nome di percorso è più lungo di MAXPATHLEN.

       ENOENT Un nome di percorso era vuoto o aveva un componente inesistente.

       ENOMEM Il kernel non può allocare una pagina libera in cui copiare nomi di file o dati.

       EPERM  Il chiamante non ha i privilegi necessari.

VERSIONI

       MNT_DETACH e MNT_EXPIRE sono disponibili in glibc sin dalla versione 2.11.

CONFORME A

       Queste funzioni sono specifiche di Linux e non devono  essere  usate  in  programmi  pensati  per  essere
       portabili.

NOTE

       La  funzione  originale  umount() era chiamata come umount(device) e restituiva ENOTBLK quando non veniva
       chiamata da un dispositivo a blocchi.  In Linux 0.98p4 fu aggiunta una chiamata  umount(dir),  per  poter
       supportare  dispositivi  anonimi.   In Linux 2.3.99-pre7 la chiamata umount(device) fu rimossa, lasciando
       solo umount(dir) (poiché ora i dispositivi possono essere montati in più di un posto, così specificare il
       dispositivo non è sufficiente).

VEDERE ANCHE

       mount(2), path_resolution(7), mount(8), umount(8)

COLOPHON

       Questa  pagina fa parte del rilascio 3.73 del progetto Linux man-pages.  Una descrizione del progetto, le
       istruzioni per la  segnalazione  degli  errori,  e  l'ultima  versione  di  questa  pagina  si  trova  su
       http://www.kernel.org/doc/man-pages/.

       La  versione  italiana  fa  parte  del  pacchetto  man-pages-it  v.  3.73, a cura di: ILDP "Italian Linux
       Documentation Project" http://www.pluto.it/ildp
       Per la traduzione in italiano si può fare riferimento a http://www.pluto.it/ildp/collaborare/
       Segnalare eventuali errori di traduzione a ildp@pluto.it