НАЗВА

       guestunmount — демонтування змонтованої за допомогою guestmount файлової системи

КОРОТКИЙ ОПИС

        guestunmount точка_монтування

        guestunmount --fd=<дескрипто_файла> точка монтування

ОПИС

       guestunmount — програма для автоматичного вилучення змонтованих файлових систем.
       guestmount(1) монтує файлові системи за допомогою libguestfs. Ця програма демонтує файлову
       систему, коли програма або скрипт завершує роботу з нею.

       guestunmount є обгорткою навколо програми FUSE fusermount(1), яка має зберігатися у одному
       з каталогів, вказаних за допомогою поточної змінної "PATH".

       Існує два способи використання guestunmount. Якщо програму викликано так:

        guestunmount точка_монтування

       вона демонтує точку монтування "точка_монтування" негайно.

       Якщо ж програму викликано так:

        guestunmount --fd=FD точка_монтування

       програма чекатиме, аж доки не буде закрито дескриптор файла "FD" каналу. Цим можна
       скористатися для спостереження за іншим процесом і вилучення точки монтування після
       завершення роботи процесу, як це описано нижче.

   З ПРОГРАМ
       Ви можете просто викликати "guestunmount точка_монтування" з програми, але розумніше було
       б скористатися guestunmount так, щоб ця програма спостерігала за вашою програмою і
       вилучала точку монтування, якщо програма неочікувано завершить роботу.

       У програмі створіть канал обробки (наприклад, за допомогою виклику pipe(2)). Нехай "FD" є
       номером дескриптора файла з боку читання у каналі (тобто "pipefd[0]").

       Після монтування файлової системи за допомогою guestmount(1) (до точки монтування
       "точка_монтування") виконайте відгалуження (fork) і запустіть guestunmount ось так:

        guestunmount --fd=FD точка_монтування

       Закрийте бік читання у каналі обробки у батьківському процесі.

       Тепер, коли з якоїсь причини буде закрито бік запису у каналі (тобто "pipefd[1]"), явно
       або у результаті завершення роботи батьківського процесу, guestunmount зауважить це і
       демонтує точку монтування.

       Якщо у вашій операційній системі передбачено підтримку цього, вам слід встановити
       прапорець "FD_CLOEXEC" на боці запису у каналі. Таким чином ви забороните іншим дочірнім
       процесам успадковувати дескриптор файла і тримати його відкритим.

       Guestunmount ніколи не перетворюється на фонову службу.

   ЗІ СКРИПТІВ ОБОЛОНКИ
       Оскільки у bash не передбачено способу створення неіменованого каналу обробки,
       скористайтеся trap для виклику guestunmount при виході, ось так:

        trap "guestunmount точка_монтування" EXIT INT QUIT TERM

ПАРАМЕТРИ

       --fd=FD
           Вкажіть дескриптор файла каналу для спостереження і відкладіть вилучення до закриття
           каналу.

       --help
           Показати короткі довідкові дані і завершити роботу.

       -q
       --quiet
           Не показувати повідомлень про помилки від fusermount. Стан повернення все одно буде
           встановлено (див. "СТАН ВИХОДУ" нижче).

       --no-retry
       --retry=N
           Типово, guestunmount виконуватиме повторні спроби fusermount аж до 5 разів (тобто
           загалом буде виконано 6 спроб = 1 перша спроба + 5 повторних спроб).

           Скористайтеся параметром --no-retry, щоб наказати guestunmount запускати fusermount
           лише один раз.

           Скористайтеся параметром --retry=N, щоб наказати guestunmount виконувати "N" повторних
           спроб замість 5.

           guestunmount збільшує час між спробами експоненційно, очікуючи 1 секунду, 2 секунди,
           4 секунди тощо перед кожною повторною спробою.

       -V
       --version
           Показати дані щодо версії програми, потім вийти.

ЗМІННІ СЕРЕДОВИЩА

       "PATH"
           Програма fusermount(1) (є частиною комплекту FUSE) має зберігатися у одному з
           каталогів, вказаних за допомогою поточної змінної "PATH".

СТАН ВИХОДУ

       Ця програма повертає значення 0 у разі успішного завершення або один із таких кодів
       помилок:

       1   Помилка програми, наприклад, не вдалося отримати достатній обсяг пам'яті, не вдалося
           запустити fusermount.  Щоб дізнатися більше, ознайомтеся із виведеним повідомленням
           про помилку.

       2   Не вдалося демонтувати точку монтування навіть після повторних спроб. Дані щодо
           базової помилки fusermount буде показано у виведеному повідомленні про помилку.

       3   Точку монтування не змонтовано.

ТАКОЖ ПЕРЕГЛЯНЬТЕ

       guestmount(1), fusermount(1), pipe(2), "ЛОКАЛЬНЕ МОНТУВАННЯ" in guestfs(3),
       http://libguestfs.org/, http://fuse.sf.net/.

АВТОРИ

       Richard W.M. Jones ("rjones at redhat dot com")

АВТОРСЬКІ ПРАВА

       © Red Hat Inc., 2013

LICENSE

BUGS

       To get a list of bugs against libguestfs, use this link:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       To report a new bug against libguestfs, use this link:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       When reporting a bug, please supply:

       •   The version of libguestfs.

       •   Where you got libguestfs (eg. which Linux distro, compiled from source, etc)

       •   Describe the bug accurately and give a way to reproduce it.

       •   Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug
           report.