%
% dhcpc.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel DHCPC %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{DHCP Client}
\marklabel{DHCPCADMIN}{}
\index{DHCPC}

\section{Allgemeines}

    Das \emph{'dhcpc'} Paket stellt einen DHCP Client bereit.

    Das DHCP (Dynamic Host Configuration Protocol) wird zur Automatisierung
    der Konfiguration von Computern in TCP/IP-Netzwerken genutzt.
    Der DHCP Client kann dabei die IP-Adresse, Netmask, Domian Name, Gateway
    und DNS Nameserver automatisch vom DHCP Server beziehen.

    In diesem Paket wird der 'udhcpc' Dienst der busybox verwendet.

    Dieses Paket ist besonders f"ur USB-Stick Installation interessant, da
    es bei wechselnden Boot Prozessen an verschiedenen Maschinen, die
    erforderlichen Netzwerk Informationen automatisch ermittelt.

    In der \emph{DHCPC}-Konfiguration werden die f"ur den Dienst notwendigen
    Einstellungen vorgenommen.



\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{llll}
    & 1. &  System administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & 2. &  Network administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. &  DHCP Client administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}ll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & Advanced configuration file handling \\
    & 4. & Show status \\
    & 5. & Stop service \\
    & 6. & Start service \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration'
    ge"andert werden.

\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will, findet
    sie unter \\
    \texttt{/etc/config.d/dhcpc}


\section{Die Parameter}


\begin{description}

\config{START\_DHCPC}
{START\_DHCPC}
{STARTDHCPC}
{
    F"ur die Aktivierung des 'DHCPC' Dienstes muss dieser Parameter
    lediglich auf den Wert 'yes' gestellt werden. Die Einstellung 'no'
    schaltet den 'DHCPC' Dienst ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_DHCPC='no'}
}


\config{DHCPC\_BIND\_ETH}
{DHCPC\_BIND\_ETH}
{DHCPCBINDETH}
{
    Bei diesem Parameter wird das Interface angegeben.

    Hier wird kein echter Netzwerk-Ger"ate Namen angegeben sondern der
    Index der Angabe IP\_ETH\_x\_NAME aus der Base  Konfiguration in
    /etc/config.d/base.

    Der Index kann, wenn der Editor \glqq{}\ece\grqq{} eingestellt ist,
    auch aus dem Dialog eingef"ugt werden.

    G"ultige Werte: 1, 2  etc...

    Standardeinstellung: \texttt{DHCPC\_BIND\_ETH='1'}
}


\config{DHCPC\_USE\_PEERDNS}
{DHCPC\_USE\_PEERDNS}
{DHCPCUSEPEERDNS}
{
    Wenn der Nameserver (DNS) den der DHCP Server "ubermittelt
    verwendet  werden soll, ist hier 'yes' anzugeben. Wird der
    Nameserver aus der 'base Konfiguration' verwendet 'no'.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DHCPC\_USE\_PEERDNS='yes'}
}


\config{DHCPC\_SET\_DEFAULT\_ROUTE}
{DHCPC\_SET\_DEFAULT\_ROUTE}
{DHCPCSETDEFAULTROUTE}
{
    Wenn die Route die der DHCP Server "ubermittelt verwendet
    werden soll, ist hier 'yes' anzugeben. Wird die Route aus der
    'base Konfiguration' verwendet 'no'.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DHCPC\_SET\_DEFAULT\_ROUTE='yes'}
}


\config{DHCPC\_HOSTNAME}
{DHCPC\_HOSTNAME}
{DHCPCHOSTNAME}
{
    "Uber diesen Parameter wird der Hostname angegeben.

    G"ultige Werte: Hostname

    Standardeinstellung: \texttt{DHCPC\_HOSTNAME='HOSTNAME'}
}
\end{description}


\subsection{Spezielle Aufrufparameter}

    udhcpc [-Cfbnqtvo] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]
        [-p pidfile] [-r IP] [-s script] [-O dhcp-option]...

    \begin{tabular}{llll}
    & \texttt{-V,--vendorclass=CLASSID}  & & \texttt{Vendor class identifier} \\
    & \texttt{-i,--interface=INTERFACE}  & & \texttt{Interface to use (default eth0)} \\
    & \texttt{-H,-h,--hostname=HOSTNAME} & & \texttt{Client hostname} \\
    & \texttt{-c,--clientid=CLIENTID}    & & \texttt{Client identifier} \\
    & \texttt{-C,--clientid-none}        & & \texttt{Suppress default client identifier} \\
    & \texttt{-p,--pidfile=file}         & & \texttt{Create pidfile} \\
    & \texttt{-r,--request=IP}           & & \texttt{IP address to request} \\
    & \texttt{-s,--script=file}          & & \texttt{Run file at DHCP events (default} \\
    &                                    & & \texttt{/usr/share/udhcpc/default.script)} \\
    & \texttt{-t,--retries=N}            & & \texttt{Send up to N request packets} \\
    & \texttt{-T,--timeout=N}            & & \texttt{Try to get a lease for N seconds (default 3)} \\
    & \texttt{-A,--tryagain=N}           & & \texttt{Wait N seconds (default 20) after failure} \\
    & \texttt{-O,--request-option=OPT}   & & \texttt{Request DHCP option OPT (cumulative)} \\
    & \texttt{-o,--no-default-options}   & & \texttt{Do not request any options (unless -O is} \\
    &                                    & & \texttt{also given)} \\
    & \texttt{-f,--foreground}           & & \texttt{Run in foreground} \\
    & \texttt{-b,--background}           & & \texttt{Background if lease is not immediately} \\
    &                                    & & \texttt{obtained} \\
    & \texttt{-S,--syslog}               & & \texttt{Log to syslog too} \\
    & \texttt{-n,--now}                  & & \texttt{Exit with failure if lease is not} \\
    &                                    & & \texttt{immediately obtained} \\
    & \texttt{-q,--quit}                 & & \texttt{Quit after obtaining lease} \\
    & \texttt{-R,--release}              & & \texttt{Release IP on quit} \\
    & \texttt{-a,--arping}               & & \texttt{Use arping to validate offered address} \\
    \end{tabular}

\jump{MENUSYSTEMNETWORK}{Zur"uck zum Men"u: Network administration}
