NAME

       pydhcp - a dhcp command line tool

USAGE

       pydhcp --input <TYPE;OPTIONS;NAME> --output <TYPE;OPTIONS;NAME>

DESCRIPTION

       pydhcp  is a command line tool to read or write dhcp packet on network, and translate from
       raw data to human readable informations (and vice-et-versa).  pydhcp  is  a  part  of  the
       pydhcplib python library.

Input and Output field description

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

       pydhcp --input 'device;binary|up;eth0:68' --output 'file;readable;myfile.txt' -c 1

<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.

       -c|--count
              Number of packets to process.

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;"

SEE ALSO

       pydhcplib

BUGS

       Many...

AUTHOR

       Mathieu Ignacio (mignacio[AT]april.org)

                                                                                        pydhcp(8)