NAME

       dbfdump - dump xBase DBF files as text

SYNOPSIS

       dbfdump [-h] [-m] [-r] file

DESCRIPTION

       Dumps  the  contents  of file to standard output.  The first line contains the field names
       appearing in file, and each of the following lines contains the field values of a  record.
       Field  names  and  values  are  padded  by spaces to their field widths.  Empty fields are
       printed as the string "(NULL)".

OPTIONS

       -h     Prints the column field definitions before other  output.   Each  field  definition
              consists of a line of the form

              Field: index, Type=type, Title=`name', Width=width, Decimals=precision

              where  index  is the zero offset column number of the field; the type indicates the
              datatype of the field value and is either "Integer", "Real" or  "String";  name  is
              the  field's name; width is the number of bytes reserved for the field's value; and
              precision is the number of decimal places of precision for "Real" type fields,  and
              is zero for "Integer" and "String" type fields.

       -m     Prints each record in multiline format separated by empty lines.  The first line of
              a record gives the number of the record in the form

              Records: record_index

              where record_index is the zero offset number of the record in the  file,  and  then
              each field of the record appears on its own line in the format

              name: value

       -r     Prints  the  exact bytes occurring in file for field values and suppresses printing
              "(NULL)" for empty values.

EXIT STATUS

       0      Successful program execution.

       1      Missing file argument.

       2      Failed to open file.

       3      There are no fields in file.

DIAGNOSTICS

       The following diagnostics may be issued on stdout:

       DBFOpen(file,"r") failed.

       There are no fields in this table!

AUTHORS

       Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the shapelib shapefile library.
       Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote this man page.

BUGS

       Unless  the  -r  option is given, values in numeric fields that overflow the int or double
       types of the C language are printed as plus or minus a huge number.   For  integer  fields
       the huge value is HUGE_VALL from <stdlib.h> and for real fields it is HUGE_VALF.

SEE ALSO

       dbf_dump(1), dbfcreate(1), dbfadd(1), shpadd(1), shpcreate(1), shpdump(1), shprewind(1)