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>