.\" -*- coding: UTF-8 -*- .\" Copyright (C) 1993 Rickard E. Faith .\" and Copyright (C) 1994 Andries E. Brouwer .\" and Copyright (C) 2002, 2005 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" 2008-10-06, mtk: Created this as a new page by splitting .\" umount/umount2 material out of mount.2 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH umount 2 "23 luglio 2024" "Linux man\-pages 6.12" .SH NOME umount, umount2 \- smonta i filesystem .SH LIBRERIA Standard C library (\fIlibc\fP,\ \fI\-lc\fP) .SH SINTASSI .nf \fB#include \fP .P \fBint umount(const char *\fP\fItarget\fP\fB);\fP \fBint umount2(const char *\fP\fItarget\fP\fB, int \fP\fIflags\fP\fB);\fP .fi .SH DESCRIZIONE .\" Note: the kernel naming differs from the glibc naming .\" umount2 is the glibc name for what the kernel now calls umount .\" and umount is the glibc name for oldumount \fBumount\fP() e \fBumount2\fP() rimuovono il filesystem (più alto) montato su \fItarget\fP. .P Sono necessari privilegi appropriati (Linux: capacità \fBCAP_SYS_ADMIN\fP per smontare i filesystem. .P A partire da Linux 2.1.116 è stata aggiunta la chiamata di sistema \fBumount2\fP() che, come \fBumount\fP(), smonta un target, ma permette \fIopzioni\fP aggiuntive che controllano il comportamento dell'operazione: .TP \fBMNT_FORCE\fP (a partire da Linux 2.1.116) Chiede al filesystem di interrompere le richieste pendenti prima di tentare lo smontaggio. Ciò può consentire di completare lo smontaggio senza rimanere in attesa di un server inaccessibile, ma potrebbe causare perdita di dati. Se, dopo le richieste d'interruzione, alcuni processi hanno ancora riferimenti attivi al filesystem, lo smontaggio fallirà. Alla versione 4.12 di Linux \fBMNT_FORCE\fP è supportato solo sui seguenti filesystem: 9p (da Linux 2.6.16), ceph (da Linux 2.6.34), cifs (da Linux 2.6.12), fuse (da Linux 2.6.16), lustre (da Linux 3.11) e NFS (da Linux 2.1.116). .TP \fBMNT_DETACH\fP (a partire da Linux 2.4.11) Esegue uno smontaggio lento: rende il punto di mount non disponibile per i nuovi accessi, disconnette immediatamente il filesystem e tutti i filesystem montati sotto di esso sia l'uno dall'altro, sia dalla tabella di mount, ed esegue effettivamente lo smontaggio quando il punto di mount smette di essere occupato. .TP \fBMNT_EXPIRE\fP (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 \fBumount2\fP() con questa opzione fallisce con l'errore \fBEAGAIN\fP, 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 \fBumount2\fP() che specifica \fBMNT_EXPIRE\fP smonta un punto di mount scaduto. Questa opzione non può essere specificata con \fBMNT_FORCE\fP o con \fBMNT_DETACH\fP. .TP \fBUMOUNT_NOFOLLOW\fP (a partire da Linux 2.6.34) .\" Later added to Linux 2.6.33-stable Non elimina il riferimento a \fItarget\fP se è un collegamento simbolico. Questa opzione permette di evitare problemi di sicurezza in programmi set\-user\-ID\-\fIroot\fP che consentono a utenti senza privilegi di smontare i filesystem. .SH "VALORE RESTITUITO" In caso di successo restituisce zero. In caso di errore restituisce \-1, e \fIerrno\fP verrà impostato per indicare l'errore. .SH 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. .TP \fBEAGAIN\fP Una chiamata a \fBumount2\fP() che specifica \fBMNT_EXPIRE\fP ha marcato con successo un filesystem non occupato come scaduto. .TP \fBEBUSY\fP \fItarget\fP non può essere smontato in quanto occupato. .TP \fBEFAULT\fP \fItarget\fP punta fuori dallo spazio di indirizzamento dell'utente. .TP \fBEINVAL\fP \fItarget\fP non è un punto di mount. .TP \fBEINVAL\fP \fItarget\fP è bloccato; vedere \fBmount_namespaces\fP(7). .TP \fBEINVAL\fP \fBumount2\fP() è stato chiamato con \fBMNT_EXPIRE\fP e con uno fra \fBMNT_DETACH\fP o \fBMNT_FORCE\fP. .TP \fBEINVAL\fP (a partire da Linux 2.6.34) \fBumount2\fP() è stato cchiamato con un valore di opzione non valido in \fIflags\fP. .TP \fBENAMETOOLONG\fP Un nome di percorso è più lungo di \fBMAXPATHLEN\fP. .TP \fBENOENT\fP Un nome di percorso era vuoto o aveva un componente inesistente. .TP \fBENOMEM\fP Il kernel non può allocare una pagina libera in cui copiare nomi di file o dati. .TP \fBEPERM\fP Il chiamante non ha i privilegi necessari. .SH "CONFORME A" Linux. .SH STORIA .\" http://sourceware.org/bugzilla/show_bug.cgi?id=10092 \fBMNT_DETACH\fP e \fBMNT_EXPIRE\fP sono disponibili da glibc 2.11. .P La funzione originale \fBumount\fP() era chiamata come \fIumount(device)\fP e restituiva \fBENOTBLK\fP quando non veniva chiamata da un dispositivo a blocchi. In Linux 0.98p4 fu aggiunta una chiamata \fIumount(dir)\fP, per poter supportare dispositivi anonimi. In Linux 2.3.99\-pre7 la chiamata \fIumount(device)\fP fu rimossa, lasciando solo \fIumount(dir)\fP (poiché ora i dispositivi possono essere montati in più di un posto, così specificare il dispositivo non è sufficiente). .SH NOTE .SS "umount() e punti di mount condivisi" Punti di mount condivisi fanno sì che qualsiasi attività di montaggio su un punto di mount, comprese le operazioni di \fBumount\fP(), siano propagate a ogni punto di mount condiviso nel "peer group" e a ogni mount secondario di quel "peer group". Questo significa che l'azione di \fBumount\fP() di qualsiasi "peer" in un insieme di mount condivisi provocherà lo smontaggio di tutti suoi "peer" e anche di tutti i loro secondari. .P Questa propagazione dell'attivita di smontaggio può riservare sorprese specialmente nei sistemi dove ogni punto di mount è condiviso in modo predefinito. Su tali sistemi, montare ricorsivamente con un montaggio di tipo "bind" la directory radice del filesystem in una sottodirectory e poi smontare quella sottodirectory con \fBMNT_DETACH\fP provoca lo smontaggio lento di ogni montaggio nello spazio dei nomi di mount. .P Per essere sicuri che \fBumount\fP() non si propaghi in questo modo, il punto di mount può essere rimontato usando una chiamata \fBmount\fP(2) con un argomento \fImount_flags\fP che includa sia \fBMS_REC\fP sia \fBMS_PRIVATE\fP prima che \fBumount\fP() venga chiamato. .SH "VEDERE ANCHE" \fBmount\fP(2), \fBmount_namespaces\fP(7), \fBpath_resolution\fP(7), \fBmount\fP(8), \fBumount\fP(8) .PP .SH TRADUZIONE La traduzione italiana di questa pagina di manuale è stata creata da Elisabetta Galli , Marco Curreli e Giuseppe Sacco . .PP Questa traduzione è documentazione libera; leggere la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Versione 3 .UE o successiva per le condizioni di copyright. Non ci assumiamo alcuna responsabilità. .PP Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a .MT pluto-ildp@lists.pluto.it .ME .