Recent Changes - Search:

General

Docs

PmWiki

edit SideBar

EnglishPydhcpDocumentation

Site.EnglishPydhcpDocumentation History

Hide minor edits - Show changes to output

February 01, 2009, at 12:38 PM EST by 90.55.186.174 -
February 01, 2009, at 12:37 PM EST by 90.55.186.174 -
Changed line 7 from:
! Input and Output field description
to:
!! Input and Output field description
Changed line 16 from:
! <TYPE> field
to:
!! <TYPE> field
Changed line 19 from:
! <OPTIONS> field
to:
!! <OPTIONS> field
Changed line 23 from:
! <NAME> field
to:
!! <NAME> field
Changed lines 26-27 from:
! Other command line options of pydhcp
to:
!! Other command line options of pydhcp
Changed line 30 from:
! Known limitations
to:
!! Known limitations
Changed line 34 from:
! Examples
to:
!! Examples
February 01, 2009, at 12:36 PM EST by 90.55.186.174 -
Added line 36:
Added line 40:
February 01, 2009, at 12:35 PM EST by 90.55.186.174 -
Changed lines 9-10 from:
::'''pydhcp --input 'device;binary|up;eth0:68' --output 'file;readable;myfile.txt' -c 1'''::
to:

@@''' pydhcp --input 'device;binary|up;eth0:68' --output 'file;readable;myfile.txt' -c 1 '''@@
Changed lines 13-14 from:
::''' '<TYPE>;<OPTIONS>;<NAME>' '''::
to:

@@''' '<TYPE>;<OPTIONS>;<NAME>' '''@@
Changed lines 36-37 from:
::'''pydhcp -i "address;binary;0.0.0.0:67" -o "file;readable;myfile.bin" '''::
to:
@@'''pydhcp -i "address;binary;0.0.0.0:67" -o "file;readable;myfile.bin" '''@@
Changed line 39 from:
::''' pydhcp -i "file;binary;myfile.bin" -o "stdout;readable;" '''::
to:
@@''' pydhcp -i "file;binary;myfile.bin" -o "stdout;readable;" '''@@
February 01, 2009, at 12:33 PM EST by 90.55.186.174 -
Added lines 1-37:
! Pydhcp documentation

This documention is available for pydhcp version 0.5. This release is not yet published, then this document is not very useful for users :)

pydhcp takes an input and an output argument. Input and output are described in the same way.

! Input and Output field description
Here an example pydhcp usage that read 2 dhcp packets from the network device eth 0 in binary form, and copy them to the file <myfile.txt> in human readable form. If the network device eth0 id down, pydhcp set it up :
::'''pydhcp --input 'device;binary|up;eth0:68' --output 'file;readable;myfile.txt' -c 1'''::

The input/ouputsynopsis is :
::''' '<TYPE>;<OPTIONS>;<NAME>' '''::

! <TYPE> field
There is 5 types for the <TYPE> field. Only one type at once can be used : device, address, file, stdin and stdout. '''device''' tells pydhcp to write or listen directly on the network interface and port. '''address''' is to write or listen on a specific Internet Address and port (like 192.168.1.1:67 ). '''file''' read or write data from or to a file. '''stdin''' read data from stdin, '''stdout''' write data on stdout.

! <OPTIONS> field
You can use multiple options in the option field by separate them with a pipe '''|'''. There is 4 options for this field : readable, binary, up and noup. readable id to read or write data in a human readable language : a packet definition language. This language is described later. Binary form stand for reading or writing packets in the same binary form they are on the network : an UDP packet. readable and binary are mutually exclusive.
Option '''up''' tells pydhcp to set the network interface up if not. '''noup''' tells not to set up the interface. '''up''' and '''noup''' are only useful in combination with the '''device''' type. Default is noup.

! <NAME> field
Describe the name of the device (eth0:67,wlan0:client) , the address (192.168.1.1), or the filename (foo.txt). You can use a port number or the keywords client and server for standard dhcp port.

! Other command line options of pydhcp

'''Option -c''' : Number of packet to read or write. 0 for unlimited number of packet. Default is 0.

! Known limitations
* Only one dhcp packet per file, then count is set to 1 for file I/O
* No readable transfert on network (address or device). Binary only.

! Examples
Read a client packet on any address and write it on a human readable file :
::'''pydhcp -i "address;binary;0.0.0.0:67" -o "file;readable;myfile.bin" '''::

Read a binary dhcp packet from a file and print it on stdout in a human readable form :
::''' pydhcp -i "file;binary;myfile.bin" -o "stdout;readable;" '''::
Edit - History - Print - Recent Changes - Search
Page last modified on February 01, 2009, at 12:38 PM EST