VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-sharedfolder.xml@ 103068

Last change on this file since 103068 was 98103, checked in by vboxsync, 23 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 10.4 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage sharedfolder
4-->
5<!--
6 Copyright (C) 2006-2023 Oracle and/or its affiliates.
7
8 This file is part of VirtualBox base platform packages, as
9 available from https://www.virtualbox.org.
10
11 This program is free software; you can redistribute it and/or
12 modify it under the terms of the GNU General Public License
13 as published by the Free Software Foundation, in version 3 of the
14 License.
15
16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, see <https://www.gnu.org/licenses>.
23
24 SPDX-License-Identifier: GPL-3.0-only
25-->
26<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
27 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
28<!ENTITY % all.entities SYSTEM "all-entities.ent">
29%all.entities;
30]>
31<refentry id="vboxmanage-sharedfolder" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage sharedfolder</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-sharedfolder</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-sharedfolder</refname>
44 <refpurpose>добавление или удаление общих папок</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-sharedfolder-add">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage sharedfolder add</command>
52 <group choice="req">
53 <arg choice="plain"><replaceable>uuid</replaceable></arg>
54 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
55 </group>
56 <arg choice="req">--name=<replaceable>имя</replaceable></arg>
57 <arg choice="req">--hostpath=<replaceable>путь-в-хост-системе</replaceable></arg>
58 <arg>--readonly</arg>
59 <arg>--transient</arg>
60 <arg>--automount</arg>
61 <arg>--auto-mount-point=<replaceable>путь</replaceable></arg>
62 </cmdsynopsis>
63
64 <cmdsynopsis id="synopsis-vboxmanage-sharedfolder-remove">
65 <command>VBoxManage sharedfolder remove</command>
66 <group choice="req">
67 <arg choice="plain"><replaceable>uuid</replaceable></arg>
68 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
69 </group>
70 <arg choice="req">--name=<replaceable>имя</replaceable></arg>
71 <arg>--transient</arg>
72 </cmdsynopsis>
73 </refsynopsisdiv>
74
75 <refsect1>
76 <title>Описание</title>
77 <para>
78 Общие папки позволяют предоставить совместный доступ к данным
79 между хост-системой и гостевыми системами. Для использования
80 общих папок, сначала надо установить Дополнения Гостевой ОС
81 &product-name; в гостевой ОС.
82 </para>
83 <para>
84 Общая папка связана с именем разделяемого ресурса и полным
85 путем к папке или директории в хост-системе. Имя разделяемого
86 ресурса - это уникальное имя в пространстве имен ОС хоста.
87 </para>
88 <refsect2 id="vboxmanage-sharedfolder-add">
89 <title>Добавить общую папку</title>
90 <remark role="help-copy-synopsis"/>
91 <para>
92 Команда <command>VBoxManage sharedfolder add</command> создает
93 общую папку. Папка указывается в хост-системе. Когда папка
94 настроена, к содержимому папки в хост-системе может быть
95 предоставлен совместный доступ в гостевых ОС.
96 </para>
97 <variablelist>
98 <varlistentry>
99 <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term>
100 <listitem><para>
101 Задает имя или UUID гостевой ВМ, которая разделяет папку
102 с хост-системой.
103 </para></listitem>
104 </varlistentry>
105 <varlistentry>
106 <term>--name=<replaceable>имя</replaceable></term>
107 <listitem><para>
108 Задает имя разделяемого ресурса, который имеет
109 уникальное имя в пространстве имен ОС хоста.
110 </para></listitem>
111 </varlistentry>
112 <varlistentry>
113 <term>--hostpath=<replaceable>путь-в-хост-системе</replaceable></term>
114 <listitem><para>
115 Задает абсолютный путь к папке или директории в ОС хоста
116 для предоставления доступа гостевым ОС.
117 </para></listitem>
118 </varlistentry>
119 <varlistentry>
120 <term>--readonly</term>
121 <listitem><para>
122 Указывает, что разделяемый ресурс имеет доступ только
123 для чтения к файлам хоста.
124 </para><para>
125 По умолчанию, общие папки имеют доступ на чтение и на
126 запись к файлам хоста. Однако, в дистрибутивах Linux,
127 общие папки монтируются с файловыми разрешениями 770,
128 пользователем <literal>root</literal> и группой
129 <literal>vboxsf</literal>. Эта опция устанавливает
130 файловые разрешения в 700.
131 </para></listitem>
132 </varlistentry>
133 <varlistentry>
134 <term>--transient</term>
135 <listitem><para>
136 Задает что разделяемый ресурс временный, что означает, что
137 он может быть добавлен и удален в время выполнения и не
138 сохраняется после выключения ВМ.
139 </para></listitem>
140 </varlistentry>
141 <varlistentry>
142 <term>--automount</term>
143 <listitem><para>
144 Указывает, что разделяемый ресурс монтируется автоматически.
145 </para></listitem>
146 </varlistentry>
147 <varlistentry>
148 <term>--auto-mount-point=<replaceable>путь</replaceable></term>
149 <listitem><para>
150 Задает точку монтирования разделяемого ресурса. Зависит от гостевой ОС.
151 </para><para>
152 Для гостевых систем Windows и OS/2 она должна быть неиспользуемой
153 буквой диска. Если оставить пустым (или указать используемую
154 букву диска), будет использована последняя неиспользуемая буква
155 диска вместо указанной (то есть ищется буква с <literal>Z:</literal>
156 по <literal>A:</literal>).
157 </para><para>
158 Для Linux, Solaris и других гостевых систем UNIX, он должен быть
159 абсолютным путем, например <filename>/mnt/mysharedfolder</filename>.
160 Если оставить пустым, расположение по умолчанию будет
161 <filename>/media/sf_<replaceable>имя-общей-папки</replaceable></filename>.
162 </para></listitem>
163 </varlistentry>
164 </variablelist>
165 </refsect2>
166 <refsect2 id="vboxmanage-sharedfolder-remove">
167 <title>Удалить общую папку</title>
168 <remark role="help-copy-synopsis"/>
169 <para>
170 Команда <command>VBoxManage sharedfolder remove</command>
171 удаляет общую папку.
172 </para>
173 <variablelist>
174 <varlistentry>
175 <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term>
176 <listitem><para>
177 Задает имя или UUID гостевой ВМ, которая разделяет папку
178 с хост-системой.
179 </para></listitem>
180 </varlistentry>
181 <varlistentry>
182 <term>--name=<replaceable>имя</replaceable></term>
183 <listitem><para>
184 Задает имя удаляемого разделяемого ресурса.
185 </para></listitem>
186 </varlistentry>
187 <varlistentry>
188 <term>--transient</term>
189 <listitem><para>
190 Указывает, что папка временная, что означает что она
191 может быть добавлена и удалена во время выполнения и не
192 сохраняется после выключения ВМ.
193 </para></listitem>
194 </varlistentry>
195 </variablelist>
196 </refsect2>
197 </refsect1>
198
199 <refsect1>
200 <title>Примеры</title>
201 <remark role="help-scope" condition="GLOBAL" />
202 <para>
203 Следующая команда создает общую папку, называемую
204 <filename>o7share</filename> для ВМ <filename>ol7</filename>.
205 Папка монтируется автоматически при старте ВМ.
206 </para>
207<screen>$ VBoxManage sharedfolder add ol7 --name ol7share --hostpath "/home/user/ol7share" --automount</screen>
208 <para>
209 Следующая команда удаляет общую папку, называемую
210 <filename>o7share</filename> из ВМ <filename>ol7</filename>.
211 </para>
212<screen>$ VBoxManage sharedfolder remove ol7 --name ol7share</screen>
213 </refsect1>
214</refentry>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette