man_VBoxManage-bandwidthctl.xml@ 95368

Last change on this file since 95368 was 94219, checked in by vboxsync, 3 years ago
doc/manual: Some cleanups in the ru_RU VBoxManage refentry documentation, bugref:9186
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 14.5 KB

Line
1	<?xml version="1.0" encoding="UTF-8"?>
2	<!--
3	manpage, user manual, usage: VBoxManage bandwidthctl
4
5	Copyright (C) 2006-2020 Oracle Corporation
6
7	This file is part of VirtualBox Open Source Edition (OSE), as
8	available from http://www.virtualbox.org. This file is free software;
9	you can redistribute it and/or modify it under the terms of the GNU
10	General Public License (GPL) as published by the Free Software
11	Foundation, in version 2 as it comes in the "COPYING" file of the
12	VirtualBox OSE distribution. VirtualBox OSE is distributed in the
13	hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
14	-->
15	<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
16	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
17	<!ENTITY % all.entities SYSTEM "all-entities.ent">
18	%all.entities;
19	]>
20	<refentry id="vboxmanage-bandwidthctl" lang="en">
21	<refentryinfo>
22	<pubdate>$Date: 2022-03-14 09:39:06 +0000 (Mon, 14 Mar 2022) $</pubdate>
23	<title>VBoxManage bandwidthctl</title>
24	</refentryinfo>
25
26	<refmeta>
27	<refentrytitle>VBoxManage-bandwidthctl</refentrytitle>
28	<manvolnum>1</manvolnum>
29	</refmeta>
30
31	<refnamediv>
32	<refname>VBoxManage-bandwidthctl</refname>
33	<refpurpose>управление группами полосы пропускания</refpurpose>
34	<refclass>&product-name;</refclass>
35	</refnamediv>
36
37	<refsynopsisdiv>
38	<cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-add">
39	<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
40	<command>VBoxManage bandwidthctl</command>
41	<group choice="req">
42	<arg choice="plain"><replaceable>uuid</replaceable></arg>
43	<arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
44	</group>
45	<arg choice="plain">add</arg>
46	<arg choice="req"><replaceable>имя-группы-полосы-пропускания</replaceable></arg>
47	<arg choice="req">--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k\|m\|g\|K\|M\|G]</arg>
48	<arg choice="req">--type=disk\|network</arg>
49	</cmdsynopsis>
50
51	<cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-list">
52	<command>VBoxManage bandwidthctl</command>
53	<group choice="req">
54	<arg choice="plain"><replaceable>uuid</replaceable></arg>
55	<arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
56	</group>
57	<arg choice="plain">list</arg>
58	<arg>--machinereadable</arg>
59	</cmdsynopsis>
60
61	<cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-remove">
62	<command>VBoxManage bandwidthctl</command>
63	<group choice="req">
64	<arg choice="plain"><replaceable>uuid</replaceable></arg>
65	<arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
66	</group>
67	<arg choice="plain">remove</arg>
68	<arg choice="req"><replaceable>имя-группы-полосы-пропускания</replaceable></arg>
69	</cmdsynopsis>
70
71	<cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-set">
72	<command>VBoxManage bandwidthctl</command>
73	<group choice="req">
74	<arg choice="plain"><replaceable>uuid</replaceable></arg>
75	<arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
76	</group>
77	<arg choice="plain">set</arg>
78	<arg choice="req"><replaceable>имя-группы-полосы-пропускания</replaceable></arg>
79	<arg choice="req">--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k\|m\|g\|K\|M\|G]</arg>
80	</cmdsynopsis>
81	</refsynopsisdiv>
82
83	<refsect1>
84	<title>Описание</title>
85	<para>
86	Команда <command>VBoxManage bandwidthctl</command> позволяет управлять
87	группами полосы пропускания для виртуальных машин (ВМ). Группа полосы
88	пропускания указывает лимит полосы пропускания для дисков или сетевых
89	адаптеров ВМ.
90	</para>
91	<para>
92	Обратите внимание, что лимит полосы пропускания сети применяется только
93	к исходящему траффику ВМ. Входящий траффик не ограничивается.
94	</para>
95	<refsect2 id="vboxmanage-bandwidthctl-add">
96	<title>Создание группы полосы пропускания</title>
97	<remark role="help-copy-synopsis"/>
98	<para>
99	Команда <command>VBoxManage bandwidthctl add</command> создает группу
100	полосы пропускания для указанной ВМ. Вы должны указать назначение
101	группы полосы пропускания: для дисков или сетей, а также указать
102	лимит полосы пропускания.
103	</para>
104	<variablelist>
105	<varlistentry>
106	<term><replaceable>uuid</replaceable> \| <replaceable>имя-ВМ</replaceable></term>
107	<listitem><para>
108	Указывает Универсальный Уникальный Идентификатор (UUID) или
109	имя ВМ.
110	</para></listitem>
111	</varlistentry>
112	<varlistentry>
113	<term><option><replaceable>имя-группы-полосы-пропускания</replaceable></option></term>
114	<listitem><para>
115	Указывает имя группы полосы пропускания.
116	</para></listitem>
117	</varlistentry>
118	<varlistentry>
119	<term><option>--type=disk\|network</option></term>
120	<listitem><para>
121	Указывает тип группы полосы пропускания:
122	<literal>disk</literal> и <literal>network</literal>.
123	Для дополнительной информации смотрите
124	<xref linkend="storage-bandwidth-limit" /> или <xref linkend="network_bandwidth_limit" />.
125	</para></listitem>
126	</varlistentry>
127	<varlistentry>
128	<term><option>--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k\|m\|g\|K\|M\|G]</option></term>
129	<listitem><para>
130	Указывает лимит для группы полосы пропускания. По умолчанию,
131	указывается в мегабайтах в секунду. Можно изменить это значение
132	пока ВМ работает.
133	</para><para>
134	Можно изменить единицы измерения, добавляя следующие спецификаторы
135	к лимиту полосы пропускания:
136	</para><itemizedlist>
137	<listitem><para>
138	<literal>k</literal> – килобит в секунду
139	</para></listitem>
140	<listitem><para>
141	<literal>m</literal> – мегабит в секунду
142	</para></listitem>
143	<listitem><para>
144	<literal>g</literal> – гигабит в секунду
145	</para></listitem>
146	<listitem><para>
147	<literal>K</literal> – килобайт в секунду
148	</para></listitem>
149	<listitem><para>
150	<literal>M</literal> – мегабайт в секунду
151	</para></listitem>
152	<listitem><para>
153	<literal>G</literal> – гигабайт в секунду
154	</para></listitem>
155	</itemizedlist></listitem>
156	</varlistentry>
157	</variablelist>
158	</refsect2>
159	<refsect2 id="vboxmanage-bandwidthctl-list">
160	<title>Отображение групп полосы пропускания</title>
161	<remark role="help-copy-synopsis"/>
162	<para>
163	Команда <command>VBoxManage bandwidthctl list</command> показывает
164	все группы полосы пропускания, определенные для указанной ВМ.
165	Используйте опцию <option>--machinereadable</option> для вывода
166	в машино-читаемом формате, который использует пары имя-значение.
167	</para>
168	<variablelist>
169	<varlistentry>
170	<term><replaceable>uuid</replaceable> \| <replaceable>имя-ВМ</replaceable></term>
171	<listitem><para>
172	Указывает UUID или имя ВМ.
173	</para></listitem>
174	</varlistentry>
175	<varlistentry>
176	<term><option>--machinereadable</option></term>
177	<listitem><para>
178	Выводит информацию о группах полосы пропускания в виде
179	пар имя-значение.
180	</para></listitem>
181	</varlistentry>
182	</variablelist>
183	</refsect2>
184	<refsect2 id="vboxmanage-bandwidthctl-remove">
185	<title>Удаление группы полосы пропускания</title>
186	<remark role="help-copy-synopsis"/>
187	<para>
188	Команда <command>VBoxManage bandwidthctl remove</command> удаляет
189	группу полосы пропускания.
190	</para>
191	<note>
192	<para>
193	Для успешного удаления группы полосы пропускания, убедитесь
194	что она не ссылается на диск или адаптер работающей ВМ.
195	</para>
196	</note>
197	<variablelist>
198	<varlistentry>
199	<term><replaceable>uuid</replaceable> \| <replaceable>имя-ВМ</replaceable></term>
200	<listitem><para>
201	Указывает UUID или имя ВМ.
202	</para></listitem>
203	</varlistentry>
204	<varlistentry>
205	<term><option><replaceable>имя-группы-полосы-пропускания</replaceable></option></term>
206	<listitem><para>
207	Указывает имя группы полосы пропускания.
208	</para></listitem>
209	</varlistentry>
210	</variablelist>
211	</refsect2>
212	<refsect2 id="vboxmanage-bandwidthctl-set">
213	<title>Изменение лимита группы полосы пропускания</title>
214	<remark role="help-copy-synopsis"/>
215	<para>
216	Команда <command>VBoxManage bandwidthctl set</command> изменяет
217	лимит группы полосы пропускания.
218	</para>
219	<variablelist>
220	<varlistentry>
221	<term><replaceable>uuid</replaceable> \| <replaceable>имя-ВМ</replaceable></term>
222	<listitem><para>
223	Указывает UUID или имя ВМ.
224	</para></listitem>
225	</varlistentry>
226	<varlistentry>
227	<term><option><replaceable>bandwidth-group-name</replaceable></option></term>
228	<listitem><para>
229	Указывает имя группы полосы пропускания.
230	</para></listitem>
231	</varlistentry>
232	<varlistentry>
233	<term><option>--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k\|m\|g\|K\|M\|G]</option></term>
234	<listitem><para>
235	Указывает лимит для группы полосы пропускания. По умолчанию,
236	указывается в мегабайтах в секунду. Можно изменить это значение
237	пока ВМ работает.
238	</para><para>
239	Можно изменить единицы измерения, добавляя следующие спецификаторы
240	к лимиту полосы пропускания:
241	</para><itemizedlist>
242	<listitem><para>
243	<literal>k</literal> – килобит в секунду
244	</para></listitem>
245	<listitem><para>
246	<literal>m</literal> – мегабит в секунду
247	</para></listitem>
248	<listitem><para>
249	<literal>g</literal> – гигабит в секунду
250	</para></listitem>
251	<listitem><para>
252	<literal>K</literal> – килобайт в секунду
253	</para></listitem>
254	<listitem><para>
255	<literal>M</literal> – мегабайт в секунду
256	</para></listitem>
257	<listitem><para>
258	<literal>G</literal> – гигабайт в секунду
259	</para></listitem>
260	</itemizedlist></listitem>
261	</varlistentry>
262	</variablelist>
263	</refsect2>
264	</refsect1>
265
266	<refsect1>
267	<title>Примеры</title>
268	<remark role="help-scope" condition="GLOBAL"/>
269	<para>
270	Следующий пример показывает, как использовать команду
271	<command>VBoxManage bandwidthctl</command> для создания группы
272	полосы пропускания <literal>Limit</literal> с лимитом в 20 Мбит/с.
273	Затем используется команда <command>VBoxManage modifyvm</command>
274	для назначения этой группы первому и второму адаптерам ВМ
275	<literal>vm1</literal>.
276	</para>
277	<screen>$ VBoxManage bandwidthctl "vm1" add Limit --type network --limit 20m
278	$ VBoxManage modifyvm "vm1" --nicbandwidthgroup1 Limit
279	$ VBoxManage modifyvm "vm1" --nicbandwidthgroup2 Limit</screen>
280	<para>
281	Можно динамически менять лимит группы полосы пропускания пока
282	ВМ работает. Следующий пример показывает как изменить лимит
283	для группы полосы пропускания <literal>Limit</literal> с 20
284	Мбит/с в 100 кбит/с:
285	</para>
286	<screen>$ VBoxManage bandwidthctl "vm1" set Limit --limit 100k</screen>
287	<para>
288	Следующая команда отключает ограничения для всех адаптеров в
289	группе полосы пропускания <literal>Limit</literal> путем установки
290	лимита в ноль (<literal>0</literal>):
291	</para>
292	<screen>$ VBoxManage bandwidthctl "vm1" set Limit --limit 0</screen>
293	</refsect1>
294	</refentry>

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-bandwidthctl.xml@ 95368

Download in other formats: