<!DOCTYPE RefEntry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" []>

<refentry lang="pl">

  <refmeta>
    <refentrytitle>dcd.console</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>dcd.console</refname>
    <refpurpose>Konsola aministracyjna huba DC - DConnectDaemon</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>telnet</command>
      <arg>nazwa hosta</arg>
      <arg>numer portu</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Opis</title>
    <para>Plik ten opisuje, w jaki sposób korzystać z administracyjnej konsoli demona Direct Connect. 
</para>
  </refsect1>

  <refsect1>
    <title>Logowanie</title>
    <para>
Do konsoli loguje się za pomocą komendy <command>telnet</command>. Domyślnym portem na którym pracuje konsola DConnectDaemon jest port <envar>511</envar>. 
Adresy hostów, z których dopuszczalne jest logowanie się do konsoli administracyjnej huba przechowywane są w pliku <filename>/usr/local/etc/console.allow</filename>.
Po telnetowaniu się na hosta, należy podać login i hasło dostępu administratora huba. Loginy i hasła przechowywane są w pliku <filename>usr/local/etc/dcd.users</filename>. 
W wypadku poprawnego podania loginu i hasła, pojawi się znak zachęty konsoli</para>
  </refsect1>

  <refsect1>
    <title>Komendy konsoli</title>
    <para>Konsola umożliwia pełne administrowanie hubem DC. Dostępne są następujące polecenia administracyjne:
</para>
    <variablelist>
      <varlistentry>
	<term>conf</term>
	<listitem>
	  <para>Wyświetla aktualną konfigurację huba</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>rehash</term>
	<listitem>
	  <para>Ponownie ładuje konfigurację huba, np. po zmianie w pliku konfiguracyjnym. Pozwala to na zmiany konfiguracji bez restartu serwera.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>quit</term>
	<listitem>
	  <para>Wyjście z konsoli administracyjnej</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>stat</term>
	<listitem>
	  <para>Wyświetla statystyki huba: liczbę zalogowanych użytkowników, wielkość udostępnianych danych i czas pracy huba.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>debug <option>[debug level]</option></term>
	<listitem>
	  <para>Określa poziom debugowania pracy huba. Domyślną wartością jest <envar>0</envar>.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>whois <option><sgmltag><</sgmltag>nick<sgmltag>></sgmltag></option></term>
	<listitem>
	  <para>Wyświetla opis użytkownika <envar>nick</envar>.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>who</term>
	<listitem>
	  <para>Wyświetla użytkowników zalogowanych do konsoli administracyjnej huba. Podaje przy tym login użytkownika, adres hosta z którego zalogowany jest użytkownik, oraz czas bezczynności.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>users</term>
	<listitem>
	  <para>Wyświetla listę użytkowników zalogowanych do huba.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>kick <option><sgmltag><</sgmltag>nick<sgmltag>></sgmltag></option> [<parameter>reason</parameter>]</term>
	<listitem>
	  <para>Odłącza od huba użytkownika <parameter><sgmltag><</sgmltag>nick<sgmltag>></sgmltag></parameter>. Jednocześnie na czacie wyświetlany jest powód <parameter>reason</parameter> odłączenia użytkownika. Jest to ulubiona komenda administratorów huba ;)</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>jq</term>
	<listitem>
	  <para>Włącza/wyłącza wyświetlanie zdarzeń podłączeń i rozłączeń użytkowników z hubem.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term>boost</term>
	<listitem>
	  <para>O tutaj mamy opis</para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>See also</title>
    <para>
<citerefentry>
	<refentrytitle>dcd</refentrytitle>
	<manvolnum>1</manvolnum>
      </citerefentry>
</para>
  </refsect1>
</refentry>