Non-virtual admin.
[stg.git] / doc / help / ch8.xml
1 <chapter xml:id="ch8">
2         <title>Описание работы с консольным конфигуратором</title>
3         <para>Консольный конфигуратор позволяет добавлять, удалять пользователей,  получать и устанавливать некоторые параметры пользователя и отправлять ему текстовые сообщения. Общий формат вызова для получения значения параметра:</para>
4 <programlisting linenumbering="unnumbered">
5 sgconf get -s &lt;server&gt; -p &lt;port&gt; -a &lt;admin&gt; -w &lt;admin_password&gt; -u &lt;user&gt; &lt;options&gt;                 
6 </programlisting>
7         <itemizedlist mark="none">
8                 <listitem><para>server — адрес сервера;</para></listitem>
9                 <listitem><para>port — порт конфигуратора на сервере;</para></listitem>
10                 <listitem><para>admin — логин администратора на сервере;</para></listitem>
11                 <listitem><para>admin_password — пароль администратора на сервере.</para></listitem>
12                 <listitem><para>user — логин пользователя на сервере.</para></listitem>
13                 </itemizedlist>
14         <para>Общий формат вызова для установки параметра, добавления или удаления пользователя:</para>
15 <programlisting linenumbering="unnumbered">
16 sgconf get -s &lt;server&gt; -p &lt;port&gt; -a &lt;admin&gt; -w &lt;admin_password&gt; -u &lt;user&gt; &lt;options&gt;                 
17 </programlisting>
18         <para>Параметры вызова — такие-же, что и при получении значения параметра.</para>
19         <itemizedlist mark="none">
20                 <listitem><para>-c &lt;add_cash[:log_message]&gt; — добавление денег на счет пользователя. add_cash — добавляемая сумма, log_message — опциональный коментарий для записи в лог.</para></listitem>
21                 <listitem><para>-v &lt;set_cash[:log_message]&gt; — установка денег на счету пользователя. set_cash — устанавливаемая сумма, log_message — опциональный коментарий для записи в лог.</para></listitem>
22                 <listitem><para>-c — при использовании без параметра возвращает состояние счета пользователя.</para></listitem>
23                 <listitem><para>-t &lt;tariff:now|delayed&gt; — смена тарифа пользователя. tariff — название тарифа, now — изменить немедленно, delayed — изменить в конце месяца.</para></listitem>
24                 <listitem><para>-t — при использовании без параметра возвращает текущий тариф пользователя.</para></listitem>
25                 <listitem><para>-r &lt;credit&gt; — предоставление пользователю кредита в размере credit.</para></listitem>
26                 <listitem><para>-r — при использовании без параметров возвращает текущий кредит.</para></listitem>
27                 <listitem><para>-E &lt;YYYY-MM-DD&gt; — указание срока истечения кредита пользователю.</para></listitem>
28                 <listitem><para>-E — при использовании без параметров возвращает текущий срок истечения кредита пользователю.</para></listitem>
29                 <listitem><para>-o &lt;new_password&gt; — установка пользователю пароля new_password.</para></listitem>
30                 <listitem><para>-o — при использовании без параметра возвращает текущий пароль пользователя.</para></listitem>
31                 <listitem><para>-e &lt;prepaid&gt; — установка количества предоплаченного трафика.</para></listitem>
32                 <listitem><para>-e — при использовании без параметра возвращает количество оставшегося предоплаченного трафика.</para></listitem>
33                 <listitem><para>-I &lt;*ip_addr[,ip_addr]&gt; — установка IP-адреса пользователя (одного, нескольких или произвольного).</para></listitem>
34                 <listitem><para>-I — при использовании без параметра возвращает текущий IP-адрес пользователя.</para></listitem>
35                 <listitem><para>-A &lt;name&gt; — установка реального имени пользователя.</para></listitem>
36                 <listitem><para>-A — при использовании без параметра возвращает реальное имя пользователя.</para></listitem>
37                 <listitem><para>-N &lt;note&gt; — установка коментария к пользователю.</para></listitem>
38                 <listitem><para>-N — при использовании без параметров возвращает коментарий к пользователю.</para></listitem>
39                 <listitem><para>-D &lt;address&gt; — установка реального адреса пользователя.</para></listitem>
40                 <listitem><para>-D — при использовании без параметра возвращает адрес пользователя.</para></listitem>
41                 <listitem><para>-L &lt;email&gt; — установка email-адреса пользователя.</para></listitem>
42                 <listitem><para>-L — при использовании без параметра возвращает адрес Email пользователя.</para></listitem>
43                 <listitem><para>-P &lt;phone&gt; — установка телефона пользователя.</para></listitem>
44                 <listitem><para>-P — при использовании без параметров возвращает телефон пользователя.</para></listitem>
45                 <listitem><para>-G &lt;group&gt; — установка группы пользователя.</para></listitem>
46                 <listitem><para>-G — при использовании без параметра возвращает текущую группу пользователя.</para></listitem>
47                 <listitem><para>-d &lt;1|0&gt; — включение/выключение пользователя.</para></listitem>
48                 <listitem><para>-d — при использовании без параметров возвращает текущее состояние пользователя (включен/выключен, а не online/offline).</para></listitem>
49                 <listitem><para>-i &lt;1|0&gt; — «заморозка»/«разморозка» пользователя.</para></listitem>
50                 <listitem><para>-i — при использовании без параметра возвращает текущее состояние пользователя («заморожен»/«разморожен»).</para></listitem>
51                 <listitem><para>--disable-stat &lt;1|0&gt; — включение/выключение ведения детальной статистики для пользователя.</para></listitem>
52                 <listitem><para>--disable-stat — при использовании без параметра возвращает состояние флага ведения детальной статистики для пользователя.</para></listitem>
53                 <listitem><para>--always-online &lt;1|0&gt; — включение/выключение режима Always Online для пользователя.</para></listitem>
54                 <listitem><para>--always-online — при использовании без параметра возвращает режим пользователя.</para></listitem>
55                 <listitem><para>--u0 &lt;traff&gt; [--u1 &lt;traff&gt; ...] — установка количества исходящего трафика за месяц по направлениям (0 — 9).</para></listitem>
56                 <listitem><para>--u0 [--u1 ...] — при использовании без параметров возвращает количество исходящего трафика по направлениям.</para></listitem>
57                 <listitem><para>--d0 &lt;traff&gt; [--d1 &lt;traff&gt; ...] — установка количества входящего трафика за месяц по направлениям (0 — 9).</para></listitem>
58                 <listitem><para>--d0 [--d1 ...] — при использовании без параметров возвращает количество входящего трафика по направлениям.</para></listitem>
59                 <listitem><para>--ud0 &lt;userdata&gt; [--ud1 &lt;userdata&gt; ...] — установка полей UserData&lt;0-9&gt;.</para></listitem>
60                 <listitem><para>--ud0 [--ud1 ...] — при использовании без параметра возвращает поля UserData&lt;0-9&gt;.</para></listitem>
61                 <listitem><para>-m &lt;message&gt; — отправляет пользователю сообщение.</para></listitem>
62                 <listitem><para>-n — добавляет нового «пустого» пользователя.</para></listitem>
63                 <listitem><para>-l — удаляет пользователя.</para></listitem>
64         </itemizedlist>
65         </chapter>