.\" -*- coding: UTF-8 -*- .\" Copyright (C) 1993 Rickard E. Faith .\" and Copyright (C) 1994 Andries E. Brouwer .\" and Copyright (C) 2002, 2005 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" 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 "9 giugno 2020" Linux "Manuale del programmatore di Linux" .SH NOME umount, umount2 \- smonta i filesystem .SH SINTASSI .nf \fB#include \fP .PP \fBint umount(const char *\fP\fItarget\fP\fB);\fP .PP \fBint umount2(const char *\fP\fItarget\fP\fB, int \fP\fIopzioni\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. .PP Sono necessari privilegi appropriati (Linux: capacità \fBCAP_SYS_ADMIN\fP per smontare i filesystem. .PP 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 da ogni altro e 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 specificato con \fBMNT_FORCE\fP o con \fBMNT_DETACH\fP. .TP \fBUMOUNT_NOFOLLOW\fP (a partire da Linux 2.6.34) .\" Later added to 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 di conseguenza. .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 \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 VERSIONI .\" http://sourceware.org/bugzilla/show_bug.cgi?id=10092 \fBMNT_DETACH\fP e \fBMNT_EXPIRE\fP sono disponibili in glibc sin dalla versione 2.11. .SH "CONFORME A" Queste funzioni sono specifiche di Linux e non devono essere usate in programmi pensati per essere portabili. .SH NOTE .SS "umount() e punti di mount \(dqshared mount\(dq" 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 "slave mount" di quel "peer group". Questo significa che l'azione di \fBumount\fP() di qualsiasi "peer" in una serie di "shared mount" provocherà lo smontaggio di tutti suoi "peer" e anche di tutti i loro "slave". .PP Questa propagazione dell'attivita di smontaggio può riservare sorprese specialmente nei sistemi dove ogni punto di mount è condiviso (shared) 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 "lazy" di ogni montaggio nello spazio dei nomi di mount. .PP 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. .SS "Dettagli storici" 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 "VEDERE ANCHE" \fBmount\fP(2), \fBmount_namespaces\fP(7), \fBpath_resolution\fP(7), \fBmount\fP(8), \fBumount\fP(8) .SH COLOPHON Questa pagina fa parte del rilascio 5.10 del progetto Linux \fIman\-pages\fP. Una descrizione del progetto, le istruzioni per la segnalazione degli errori, e l'ultima versione di questa pagina si trovano su \%https://www.kernel.org/doc/man\-pages/. .SH TRADUZIONE La traduzione italiana di questa pagina di manuale è stata creata da Elisabetta Galli e Marco Curreli . 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à. Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a .MT pluto-ildp@lists.pluto.it .ME .