DHCP-Client (dhcpc.c)


Funktionen

unsigned int DHCP_GetConfig (void)
 DHCP-Client Funktion. Bezieht von einem DHCP-Server automatisch eine IP-Konfiguration.
unsigned int DHCP_SendRequest (unsigned int SOCKET, unsigned char *DHCPbuffer, unsigned char *Configbuffer)
 Erstellt eine DHCP-Request Nachricht und sendet sie, anschliessend wird auf die Bestaetigung der selben mit einer DHCP-Ack Nachricht gewartet.
Dann wird eine erste Auswertung der Optionfelder durchgefuehrt und endgueltig in die DHCP_CONFIG struct eingetragen. War dieser Vorgang erfolgreich wird ein DHCPC-OK als Returnwert zurueckgegeben, sonst DHCPC-TIMEOUT. Danach enthaelt die DHCP_CONFIG struct eine gültige Condig die benutzt werden kann.
unsigned int DHCP_SendDiscover (unsigned int SOCKET, unsigned char *DHCPbuffer, unsigned char *Configbuffer)
 Erstellt eine DHCP-Discover Nachricht und sendet sie, anschliessend wird auf die Bestaetigung der selben mit einen DHCP-Offer Nachricht gewartet.
Dann wird eine erste Auswertung der Optionfelder durchgefuehrt und in die DHCP_CONFIG struct eingetragen. War dieser Vorgang erfolgreich wird ein DHCPC-OK als Returnwert zurueckgegeben, sonst DHCPC-TIMEOUT.
unsigned int DHCP_AddOption (unsigned char Option, unsigned long ExtraData, unsigned char *Optionfield)
 Fuegt einer DHCP-Nachricht im Optionfeld eine Option hinzu. Mit dieser Funktion fuegt man dem Optionfeld eine Option hinzu. Dazu kann ein Parameter uebergeben werden der dann eingetragen wird.
unsigned int DHCP_PharseOption (void *Configbuffer, unsigned char *Optionfield)
 Ueberprueft das Optionfeld im DHCP_HEADER und Pharst es. Mit dieser Funktion wird das Optionfeld im DHCP_HEADER ueberprueft und bearbeitet, Einstellungen die benoetigt werden werden in DHCP_CONFIG gespeichert.
void DHCP_buildheader (unsigned char *DHCPbuffer)
 Baut den DHCP_HEADER- Baut den DHCP_HEADER und stellt Standartwerte ein.

Ausführliche Beschreibung

 #include "dhcpc.h" 
Uebersicht
Ein DHCP-Client. Uebernimmt due automatisch Konfiguration der Netwerkparameter. Wenn dies nicht innerhalt einer bestimmten Zit gelingt, wird die Standarteinstellung auf ip.c benutzt.

Dokumentation der Funktionen

unsigned int DHCP_AddOption unsigned char  Option,
unsigned long  ExtraData,
unsigned char *  Optionfield
 

Fuegt einer DHCP-Nachricht im Optionfeld eine Option hinzu. Mit dieser Funktion fuegt man dem Optionfeld eine Option hinzu. Dazu kann ein Parameter uebergeben werden der dann eingetragen wird.

Warnung:
Nicht alle Optionen werden genutzt oder unterstuetzt!
Parameter:
Option Name oder Nummer der Option die eingetragen werden soll.
ExtraData Wert der in das Optionfeld mit eingetragen werden soll.
Optionfield Zeiger auf das Optionfeld im DHCP_HEADER.
Rückgabe:
Anzahl der Byte die eingetragen wurden, wenn 0 zurueck gegeben wird wurde kein Eintrag vorgenommen

void DHCP_buildheader unsigned char *  DHCPbuffer  ) 
 

Baut den DHCP_HEADER- Baut den DHCP_HEADER und stellt Standartwerte ein.

Parameter:
DHCPbuffer Zeiger auf den Buffer in den der DHCP_HEADER erzeugt werden soll.
Rückgabe:
NONE

unsigned int DHCP_GetConfig void   ) 
 

DHCP-Client Funktion. Bezieht von einem DHCP-Server automatisch eine IP-Konfiguration.

Parameter:
void keine parameter noetig
Rückgabe:
Ob das bezeihen der IP-Konfiguration erfolgreich war ist an einer 0 zu erkennen die zurueck gegeben wird, wenn nicht ungleich 0

unsigned int DHCP_PharseOption void *  Configbuffer,
unsigned char *  Optionfield
 

Ueberprueft das Optionfeld im DHCP_HEADER und Pharst es. Mit dieser Funktion wird das Optionfeld im DHCP_HEADER ueberprueft und bearbeitet, Einstellungen die benoetigt werden werden in DHCP_CONFIG gespeichert.

Warnung:
Nicht alle Optionen werden genutzt oder unterstuetzt!
Parameter:
Option Name oder Nummer der Option die eingetragen werden soll.
ExtraData Wert der in das Optionfeld mit eingetragen werden soll.
Optionfield Zeiger auf das Optionfeld im DHCP_HEADER.
Rückgabe:
Anzahl der Byte die eingetragen wurden, wenn 0 zurueck gegeben wird wurde kein Eintrag vorgenommen

unsigned int DHCP_SendDiscover unsigned int  SOCKET,
unsigned char *  DHCPbuffer,
unsigned char *  Configbuffer
 

Erstellt eine DHCP-Discover Nachricht und sendet sie, anschliessend wird auf die Bestaetigung der selben mit einen DHCP-Offer Nachricht gewartet.
Dann wird eine erste Auswertung der Optionfelder durchgefuehrt und in die DHCP_CONFIG struct eingetragen. War dieser Vorgang erfolgreich wird ein DHCPC-OK als Returnwert zurueckgegeben, sonst DHCPC-TIMEOUT.

Parameter:
SOCKET Das UDP-Socket der benutzt wird zur kommunikation mit den DHCP-Server.
DHCPbuffer Zeiger auf den UDP-Buffer der zur kommunikation benutzt wird. Dieser enthälrt bei der Kommunikation den DHCP_HEADER.
Configbuffer Zeiger auf den Configbuffer (DHCP_CONFIG) in der die Koniguration zwischengespeichert wird die der DHCP-Server vorschlaegt.
Rückgabe:
DHCPC_OK (Wert 0) oder DHCPC_TIMEOUT (ungleich 0)

unsigned int DHCP_SendRequest unsigned int  SOCKET,
unsigned char *  DHCPbuffer,
unsigned char *  Configbuffer
 

Erstellt eine DHCP-Request Nachricht und sendet sie, anschliessend wird auf die Bestaetigung der selben mit einer DHCP-Ack Nachricht gewartet.
Dann wird eine erste Auswertung der Optionfelder durchgefuehrt und endgueltig in die DHCP_CONFIG struct eingetragen. War dieser Vorgang erfolgreich wird ein DHCPC-OK als Returnwert zurueckgegeben, sonst DHCPC-TIMEOUT. Danach enthaelt die DHCP_CONFIG struct eine gültige Condig die benutzt werden kann.

Parameter:
SOCKET Das UDP-Socket der benutzt wird zur kommunikation mit den DHCP-Server.
DHCPbuffer Zeiger auf den UDP-Buffer der zur kommunikation benutzt wird. Dieser enthälrt bei der Kommunikation den DHCP_HEADER.
Configbuffer Zeiger auf den Configbuffer (DHCP_CONFIG) in der die Koniguration zwischengespeichert wird die der DHCP-Server vorschlaegt.
Rückgabe:
DHCPC_OK (Wert 0) oder DHCPC_TIMEOUT (ungleich 0)


Erzeugt am Sun Sep 10 14:06:28 2006 für MikroEthernetBoard von  doxygen 1.4.6