Man Linux: Main Page and Category List

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)