Content-type: text/html
Manpage of ppddcsum
ppddcsum
Section: User Commands (1)
Updated:
Index
Return to Main Contents
NAME
ppddcsum - generates or checks a ppdd checksum
SYNOPSIS
This program allows you to use checksums to protect the data on a ppdd
device from tampering. It can generate checksums on existing data and can
check an existing checksum.
DESCRIPTION
The program works by reading all the data and generating an md5 hash and
then comparing this with an already existing md5 hash in the first 1024
bytes of the file (where it is protected by the key derived from the pass
phrase). The user can choose to check both the cipher and plain text hashes.
Normally the ciphertext hash is adequate and is much quicker.
The program normally operates on the file (or device) while it is not in
use by ppdd (i.e. before a ppddsetup -s or after a ppddsetup -d). However
in the case of root filesystem encryption it has to operate on the ppdd
device even while the filesystem is mounted. This special feature is
invoked by a -r switch and it should not be used for any other purpose.
OPTIONS
If any invalid combination of switches and arguments is used the program
displays a primitive help message. The number of arguments depends on the
switches used
Generating checksums
ppddcsum -g file_or_device
ppddcsum -gp file_or_device
Checking checksums
ppddcsum file_or_device
ppddcsum -p file_or_device
Generating root filesystem checksum
ppddcsum -gr ppdd_device
Checking root filesystem checksum
ppddcsum -r ppdd_device
-g means generate
-p means plaintext checksum
-r means root filesystem
RETURN VALUE
The program returns 0 if everything worked as expected.
The program returns 1 if anything has gone wrong.
ERRORS
All ppdd utilities display fairly meaningful errors (mostly on stderr).
In all cases the errors have a unique error number to help locate the
problem in the source code. If an error message is not clear then best
source of explanation at this stage is the source itself.
ENVIRONMENT
The program does not use any environment variables.
FILES
Files (and devices) are specified as arguments.
SEE ALSO
ppdd(1)
ppdddown(1)
ppddinit(1)
ppddmchk(1)
ppddpassw(1)
ppddsetup(1)
ppdduprev(1)
ppdecrypt(1)
ppdncrypt(1)
ppddtab(5).
(c) 1999 Allan Latham - version 0.9
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
-
- OPTIONS
-
- Generating checksums
-
- Checking checksums
-
- Generating root filesystem checksum
-
- Checking root filesystem checksum
-
-
- RETURN VALUE
-
- ERRORS
-
- ENVIRONMENT
-
- FILES
-
- SEE ALSO
-
-
This document was created by
man2html,
using the manual pages.
Time: 16:35:26 GMT, September 14, 1999