pdb(4) [debian man page]

PDB(4)																	    PDB(4)

NAME

       PDB - (Pilot Database) file format

SYNOPSIS

       #define dmDBNameLength	 32/* 31 chars + 1 null terminator */

       struct pdb_header {	 /* 78 bytes total */
	    char   name[ dmDBNameLength ];
	    Word   attributes;
	    Word   version;
	    DWord  create_time;
	    DWord  modify_time;
	    DWord  backup_time;
	    DWord  modificationNumber;
	    DWord  appInfoID;
	    DWord  sortInfoID;
	    char   type[4];
	    char   creator[4];
	    DWord  id_seed;
	    DWord  nextRecordList;
	    Word   numRecords;
       };

       struct pdb_rec_header {	 /* 8 bytes total */
	    DWord  offset;
	    struct {
		   int delete	 : 1;
		   int dirty	 : 1;
		   int busy	 : 1;
		   int secret	 : 1;
		   int category  : 4;
	    }	   attributes;
	    char   uniqueID[3];
       }

DESCRIPTION

       The  PDB (Pilot Database) file format is used by all models of the Palm Pilot and IBM Workpad.  The format consists of a header followed by
       a set of record headers followed by the records themselves.

   Word Sizes
       In the SYNOPSIS above, the types ``Byte,'' ``Word,'' and ``DWord'' are used just as in the Pilot headers.  The type  ``Byte''  is  8  bits;
       ``Word'' is 16 bits; ``DWord'' is 32 bits.  The latter two are in big-endian format.

CAVEATS

       1.  The C structures given in the SYNOPSIS above are illustrative and most likely will not work in actual C code since compilers align data
	   members on word boundaries.

       2.  The PDB file format presented here is not official and was written at the time when PDB file format was not public. It is possibly out-
	   dated.  The official standard is available on the Palm web page. (SEE ALSO)

SEE ALSO

       txt2pdbdoc(1), html2pdbtxt(1), pdbtxt2html(1), doc(4)

       Palm Computing Inc.  Palm File Format Specification, 2000.
       http://www.palmos.com/dev/support/docs/fileformats/front.html

AUTHOR

       Paul J. Lucas <pauljlucas@mac.com> Updated by Erik Schanze <eriks@debian.org>

txt2pdbdoc							  August 20, 2005							    PDB(4)

txt2pdbdoc(1)						      General Commands Manual						     txt2pdbdoc(1)

NAME

       txt2pdbdoc - Text to Doc file converter for Palm Pilots

SYNOPSIS

       txt2pdbdoc [-b] [-c] [-v] document-name file.txt file.pdb
       txt2pdbdoc -d [-D] [-v] file.pdb [ file.txt ]
       txt2pdbdoc -V

DESCRIPTION

       txt2pdbdoc  converts  a plain text file to a Doc(4) file in PDB (Pilot Database) format used by all models of the Palm Pilot.  (It can also
       convert a Doc file to plain text.)  Resultant PDB files can be downloaded directly to a Pilot during a HotSync.

       The document-name is used in the Document List view of a Doc reader application on the Pilot.

OPTIONS

       -b   Ordinarily, characters with an ASCII code less than 9 are removed and both carriage-returns and form-feeds are converted to  newlines.
	    This option suppresses that behavior.

       -c   Ordinarily, text is compressed.  This option suppresses compression.

       -d   Decode the given Doc file to text either to a file or to standard output if no file is specified.

       -D   Do	not check the file type/creator of the file to decode.	This option should be specified only if you know for sure that the file is
	    in fact some sort of Doc file.  Attempting to decode non-Doc files will result in undefined behavior and quite possibly crash.

       -v   Verbose mode.  For encoding, print progress and compression statistics per 4K of text to standard error as well as overall	statistics
	    when completed; for decoding, print progress in a ``countdown'' style.

       -V   Print the version number of txt2pdbdoc to standard output and exit.

EXAMPLE

       To convert a text file to Doc file:

	    txt2pdbdoc 'Through the Looking Glass' alice.txt alice.pdb

EXIT STATUS

       Exits with one of the values given below:

	    0	 Success.
	    1	 Error in command-line options or use.
	    2	 Unable to open source file.
	    3	 Unable to open destination file.
	    4	 Unable to read file.
	    5	 Unable to write file.
	    6	 File is not a Doc file.
	    7	 Doc file uses unknown compression type.

CAVEATS

       1.  Document  names  are  limited  to  31 characters in PDB format.  Longer names are truncated but have the 29-31st characters replaced by
	   ``...'' to indicate truncation.

       2.  The command isn't called ``txt2doc'' to avoid confusion about possibly having anything to do with Microsoft Word documents that use the
	   .doc extension.

SEE ALSO

       html2pdbtxt(1), pdbtxt2html(1), doc(4), pdb(4)

AUTHOR

       Paul J. Lucas <pauljlucas@mac.com>

txt2pdbdoc							 January 21, 2005						     txt2pdbdoc(1)