From 422a24ab12eb8ae22be9ee17de6dcc879f202f41 Mon Sep 17 00:00:00 2001 From: Fritz Elfert Date: Mon, 21 May 2001 21:30:41 +0000 Subject: Added doc of internal backup format. --- kde2/doc/en/index.docbook.in | 135 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 134 insertions(+), 1 deletion(-) (limited to 'kde2/doc/en') diff --git a/kde2/doc/en/index.docbook.in b/kde2/doc/en/index.docbook.in index c7cb68a..10412df 100644 --- a/kde2/doc/en/index.docbook.in +++ b/kde2/doc/en/index.docbook.in @@ -58,6 +58,7 @@ handling backup, restore and formatting of Psion PDAs. plptools KPsion Psion +EPOC PDA backup restore @@ -520,7 +521,139 @@ consists of three tabs: Internals -TBD + +The backup files + +The backup files, created by &kpsion; are simply gzipped tar files. +The files follow the following naming scheme: + + +TYPE-YYYY-MO-DD-HH-MI-SS.tar.gz + + where + + + TYPE + + is a single character, representing the backup type. 'I' stands for + incremental and 'F' stands for full. + + + + YYYY + + is the year of creation. + + + + MO + + is the month of creation. + + + + DD + + is the day of creation. + + + + HH + + is the hour of creation. + + + + MI + + is the minute of creation. + + + + SS + + is the second of creation. + + + + + + +The file names in the tar archives are converted to fit into general +naming scheme. All occurences of the character '%' are changed into the +string '%25', all ocurrences of '/' are changed into '%2f' and all +occurences of '\' are changed into '/'. + + +In addition to the data files on the psion, every archive contains a +special index file, where the original file attributes and the Psion's +64-bit hires filetime is stored. This file is named KPsionIncrementalIndex +for incremental backups or KPsionFullIndex for full backups. The index +file is stored in the archive's toplevel directory and is an ASCII file, +containing one line per data file with the following fields: + + +hhhhhhhh llllllll ssssssss aaaaaaaa fn + + where + + + hhhhhhhh + + is an 8-digit hexadecimal number, representing the upper half of the + file's modification time. + + + + llllllll + + is an 8-digit hexadecimal number, representing the lower half of the + file's modification time. + + + + ssssssss + + is an 8-digit hexadecimal number, representing the size of the file. + + + + aaaaaaaa + + is an 8-digit hexadecimal number, representing the native attributes of + the file. + + + + fn + + is the unconverted original absolute file name. + + + + + + +The first line of the index file contains a header of the following format: + + +#plpbackup index T + + where + + + T + + is a single character, representing the backup type. 'I' stands for + incremental and 'F' stands for full. + + + + + + + + -- cgit v1.2.3