<?xml version='1.0'?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<article>
  <section>
    <title>udevadm</title>
    <refentry lang="pl">
      <refentryinfo>
        <title>udevd</title>
        <date>Listopad 2007</date>
        <productname>udev</productname>
      </refentryinfo>

      <refmeta>
        <refentrytitle>udevadm</refentrytitle>
        <manvolnum>8</manvolnum>
        <refmiscinfo class="version"></refmiscinfo>
      </refmeta>

      <refnamediv>
	      <refname>udevadm</refname><refpurpose>obsługa demona udev</refpurpose>
      </refnamediv>

      <refsynopsisdiv>
        <cmdsynopsis>
          <command>udevadm</command>
            <arg><option>--debug</option></arg>
            <arg><option>--version</option></arg>
            <arg><option>--help</option></arg>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>udevadm info <replaceable>opcje</replaceable></command>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>udevadm trigger <optional>opcje</optional></command>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>udevadm settle <optional>opcje</optional></command>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>udevadm control <replaceable>polecenie</replaceable></command>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>udevadm monitor <optional>opcje</optional></command>
        </cmdsynopsis>
        <cmdsynopsis>
          <command>udevadm test <optional>opcje</optional> <replaceable>ścieżka_urządzenia</replaceable></command>
        </cmdsynopsis>
      </refsynopsisdiv>

      <refsect1><title>OPIS</title>
        <para>udevadm wymaga podania wewnętrznego polecenia oraz ewentualnych jego opcji. Kontroluje zachowanie działającego procesu udev, wywołuje zdarzenia jądra, zarządza kolejkami zdarzeń oraz dostarcza prosty mechanizm debugujący.</para>
      </refsect1>

      <refsect1><title>OPCJE</title>
        <variablelist>
          <varlistentry>
            <term><option>--debug</option></term>
            <listitem>
              <para>Wyświetla na wyjście błędów informacje diagnostyczne.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--version</option></term>
            <listitem>
              <para>Wyświetla wersję.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--help</option></term>
            <listitem>
              <para>Wyświetla tekst pomocy.</para>
            </listitem>
          </varlistentry>
        </variablelist>

        <refsect2><title>udevadm info <replaceable>opcje</replaceable></title>
		<para>Pyta bazę danych udev o zapisane w niej informacje na temat urządzenia.
Potrafi też pytać o właściwości urządzenia na podstawie jego reprezentacji w systemie plików /sys, by ułatwić tworzenie reguł udev pasujących do niego.</para>
          <variablelist>
            <varlistentry>
              <term><option>--query=<replaceable>typ</replaceable></option></term>
              <listitem>
                <para>Pyta bazę danych udev o określony typ danych. Wymaga podania
                <option>--path</option> lub <option>--name</option> dla zidentyfikowania podanego urządzenia. Prawidłowymi wartościami są:
                <command>name</command>, <command>symlink</command>, <command>path</command>,
                <command>env</command>, <command>all</command>.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--path=<replaceable>ścieżka_urządzenia</replaceable></option></term>
              <listitem>
		      <para>Ścieżka (od tłum.: względem /sys) urządzenia, o które chcemy zapytać.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--name=<replaceable>plik</replaceable></option></term>
              <listitem>
                <para>Nazwa pliku urządzenia lub dowiązania (od tłum: w /dev, może być ścieżką względem niego lub bezwzględną).</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--root</option></term>
              <listitem>
                <para>Główny katalog udev: <filename>/dev</filename>. W połączeniu z typami
			<command>name</command> lub <command>symlink</command> opcji query, zapytanie zwraca absolutną ścieżkę zawierającą tenże główny katalog.
		</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--attribute-walk</option></term>
              <listitem>
		      <para>Wyświetla wszystkie właściwości z sysfs podanego urządzenia mogące być później użyte w regułach UDEV dla jego dopasowania, a prócz tego właściwości wszystkich nadrzędnych urządzeń, po samą górę korzenia sysfs.
		      </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--device-id-of-file=<replaceable>plik</replaceable></option></term>
              <listitem>
                <para>Wyświetla numer główny i podrzędny urządzenia, do którego odnosi się plik (od tłum.: jego pełna ścieżka).</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--export-db</option></term>
              <listitem>
                <para>Wyświetla treść bazy danych podsystemu UDEV.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--version</option></term>
              <listitem>
                <para>Wyświetla wersję UDEV.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--help</option></term>
              <listitem>
                <para>Wyświetla tekst pomocy.</para>
              </listitem>
            </varlistentry>
          </variablelist>
        </refsect2>

        <refsect2><title>udevadm trigger <optional>opcje</optional></title>
          <para>Wyzwala zdarzenia urządzeń - UEVENT - na poziomie jądra (od tłum: potrzebne dobre spolszczenie).</para>
          <variablelist>
            <varlistentry>
              <term><option>--verbose</option></term>
              <listitem>
                <para>Wyświetl listę urządzeń, których zdarzenia będą wyzwolone.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--dry-run</option></term>
              <listitem>
		      <para>Nie wyzwalaj naprawdę zdarzenia (uruchom "na sucho"). Przydatne z opcją <option>--verbose</option></para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--retry-failed</option></term>
              <listitem>
                <para>Wyzwól tylko te zdarzenia, które zawiodły podczas poprzedniego startu.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--akcja=<replaceable>akcja</replaceable></option></term>
              <listitem>
		      <para>Typ wywołanego zdarzenia. Domyślną <replaceable>akcją</replaceable> jest "add", pozostałe to "remove" lub "change".</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--subsystem-match=<replaceable>podsystem</replaceable></option></term>
              <listitem>
                <para>Wyzwól zdarzenia dla urządzeń, które należą do pasującego <replaceable>podsystemu</replaceable>. Opcja ta może być użyta wielokrotnie i wspiera wzorce dopasowania używane w powłoce.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></term>
              <listitem>
                <para>Nie wyzwalaj zdarzeń dla urządzeń, które należą do pasującego <replaceable>podsystemu</replaceable>. Opcja ta może być użyta wielokrotnie i wspiera wzorce dopasowania używane w powłoce.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--attr-match=<replaceable>atrybut</replaceable>=<replaceable>wartość</replaceable></option></term>
              <listitem>
		      <para>
			      Wyzwól zdarzenia dla urządzeń o dopasowanym <replaceable>atrybucie</replaceable> z sysfs.
			      Jeśli <replaceable>wartość</replaceable> określona jest razem z nazwą <replaceable>atrybutu</replaceable>,
			      treść <replaceable>atrybutu</replaceable> dopasowywana jest w parze
			      z daną <replaceable>wartością</replaceable> za pomocą powłokowych wzorców dopasowania.
			      Jeśli <replaceable>wartość</replaceable> nie jest określona, sprawdzane jest tylko istnienie <replaceable>atrybutu</replaceable> w sysfs.
			      Opcja ta może być użyta wielokrotnie.
		      </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--attr-nomatch=<replaceable>atrybut</replaceable>=<replaceable>wartość</replaceable></option></term>
              <listitem>
		      <para>
			      Nie wyzwalaj zdarzeń dla urządzeń o dopasowanym <replaceable>atrybucie</replaceable> z sysfs.
			      Jeśli <replaceable>wartość</replaceable> określona jest razem z nazwą <replaceable>atrybutu</replaceable>,
			      treść <replaceable>atrybutu</replaceable> dopasowywana jest w parze
			      z daną <replaceable>wartością</replaceable> za pomocą powłokowych wzorców dopasowania.
			      Jeśli <replaceable>wartość</replaceable> nie jest określona, sprawdzane jest tylko istnienie <replaceable>atrybutu</replaceable> w sysfs.
			      Opcja ta może być użyta wielokrotnie.
		      </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--socket=<replaceable>ścieżka</replaceable></option></term>
              <listitem>
		      <para>
			      Przekaż powstałe zdarzenie do podanego gniazda zamiast wywoływać globalnego zdarzenia jądra. Wszystkie dostępne wartości darzeń wysłane będą w tym samym formacie, w jakim jądro wysyła zdarzenia uevent lub wpis
			      <option>RUN+="socket:<replaceable>ścieżka</replaceable>"</option>
			      wysyła komunikat. Jeśli pierwszym znakiem określonej <replaceable>ścieżki</replaceable> jest @, to użyte jest abstrakcyjne gniazdo z przestrzeni nazw zamiast istniejącego pliku gniazda.
		</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--env=<replaceable>KLUCZ</replaceable>=<replaceable>wartość</replaceable></option></term>
              <listitem>
                <para>Przekazuje do zdarzenia dodatkowy klucz środowiskowy. Działa tylko z opcją --socket.</para>
              </listitem>
            </varlistentry>
          </variablelist>
        </refsect2>

        <refsect2><title>udevadm settle <optional>opcje</optional></title>
          <para>Obserwuje kolejkę zdarzeń UDEV i kończy, gdy bieżące zdarzenia zostaną obsłużone.</para>
          <variablelist>
            <varlistentry>
              <term><option>--timeout=<replaceable>sekundy</replaceable></option></term>
              <listitem>
		      <para>Maksymalna liczba sekund,
			      przez jakie obserwowana ma być kolejka przed jej opróżnieniem. 
			      Domyślną wartością jest 180.
		      </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--help</option></term>
              <listitem>
                <para>Wyświetla tekst pomocy.</para>
              </listitem>
            </varlistentry>
          </variablelist>
        </refsect2>

        <refsect2><title>udevadm control <replaceable>polecenie</replaceable></title>
          <para>Modyfikuje wewnętrzny stan działającego demona podsystemu UDEV (udevd). Od tłum.: w obecnej wersji jedno z niżej podanych poleceń może być wstawione bez podwójnego minusa.</para>
          <variablelist>
            <varlistentry>
              <term><option>--log-priority=<replaceable>wartość</replaceable></option></term>
              <listitem>
                <para>Ustawia wewnętrzny poziom raportowania demona UDEV. Poprawnymi wartościami są liczbowe priorytety demona syslog lub jego słowne odpowiedniki: <option>err</option>,
                <option>info</option> and <option>debug</option>.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--stop-exec-queue</option></term>
              <listitem>
		      <para>
			      Nakazuje procesowi udevd zaprzestanie wykonywania nowych zdarzeń. 
			      Nadchodzące zdarzenia będą kolejkowane.
		      </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--start-exec-queue</option></term>
              <listitem>
                <para>Nakazuje procesowi udevd wykonywanie zdarzeń.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--reload-rules</option></term>
              <listitem>
                <para>Nakazuje procesowi udevd przeładowanie reguł określonych w plikach konfiguracyjnych.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--env=<replaceable>KLUCZ</replaceable>=<replaceable>wartość</replaceable></option></term>
              <listitem>
                <para>Ustawia globalne zmienne.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--max-childs=</option><replaceable>wartość</replaceable></term>
              <listitem>
                <para>Ustawia maksymalną liczbę zdarzeń mogących być jednocześnie obsłużonych przez demona UDEV.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--help</option></term>
              <listitem>
                <para>Wyświetla tekst pomocy.</para>
              </listitem>
            </varlistentry>
          </variablelist>
        </refsect2>

        <refsect2><title>udevadm monitor <optional>opcje</optional></title>
          <para>Nasłuchuje zdarzenia uevent jądra oraz zdarzenia wysłane przez reguły UDEV i wyświetla do konsoli ścieżkę urządzenia. Można użyć tego do analizowania czasów zdarzeń, w szczególności do porównywania momentów wystąpienia zdarzeń w jądrze i ich odpowiedników w UDEV.
          </para>
          <variablelist>
            <varlistentry>
              <term><option>--environment</option></term>
              <listitem>
                <para>Wyświetl kompletne środowisko wszystkich zdarzeń. Może to być użyte do porównania wartości dostarczonych przez jądro z dodanymi przez UDEV.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--kernel</option></term>
              <listitem>
                <para>Wyświetla zdarzenia uevent jądra.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--udev</option></term>
              <listitem>
                <para>Wyświetla zdarzenia UDEV po wykonaniu reguły.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--help</option></term>
              <listitem>
                <para>Wyświetla tekst pomocy.</para>
              </listitem>
            </varlistentry>
          </variablelist>
        </refsect2>

        <refsect2><title>udevadm test <optional>opcje</optional> <replaceable>ścieżka_urządzenia</replaceable></title>
          <para>Symuluje zdarzenie UDEV dla danego urządzenia i wyświetla informacje diagnostyczne. Nie tworzy linków ani węzłów urządzeń, chyba że zostanie to wymuszone opcją <replaceable>--force</replaceable>.</para>
          <variablelist>
            <varlistentry>
              <term><option>--action=<replaceable>akcja</replaceable></option></term>
              <listitem>
                <para>Wymusza zadaną <replaceable>akcję</replaceable>.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--subsystem=<replaceable>łańcuch</replaceable></option></term>
              <listitem>
                <para>Podsysytem <replaceable>łańcuch</replaceable>.</para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--force</option></term>
              <listitem>
		      <para>Wymusza stworzenie węzła urządzenia lub dowiązania.
			      Normalnie, test wyświetla tylko informacje diagnostyczne.
		      </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term><option>--help</option></term>
              <listitem>
                <para>Wyświetla tekst pomocy.</para>
              </listitem>
            </varlistentry>
          </variablelist>
        </refsect2>
      </refsect1>

      <refsect1><title>AUTOR</title>
        <para>Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
      </refsect1>

      <refsect1><title>TŁUMACZENIE</title>
	      <para>22.09.2008, Tomasz Nowiński <email>arctgx [at] o2.pl</email>. Oryginalny podręcznik man pochodził z wersji 0.128 udev.</para>
      </refsect1>

      <refsect1>
        <title>ZOBACZ TAKŻE</title>
        <para><citerefentry>
            <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
        </citerefentry>
        <citerefentry>
            <refentrytitle>udevd</refentrytitle><manvolnum>8</manvolnum>
        </citerefentry></para>
      </refsect1>
    </refentry>
  </section>
</article>

