Content-type: text/html
Manpage of ppddpassw
ppddpassw
Section: User Commands (1)
Updated:
Index
Return to Main Contents
NAME
ppddpassw - pass phrase related functions on a ppdd device
SYNOPSIS
Used to change master or working pass phrases and related functions,
including destroying the working phrase before a backup.
DESCRIPTION
The program ppddpassw is used on an already existing ppdd filesystem.
It requires that the user enters the valid master or working pass phrase
before any actions can be taken.
OPTIONS
If any invalid combination of switches and arguments is used the program
displays a primitive help message. The program takes not more than one
switch and the argument(s) required depends on the switch.
The following functions are available:
Pass phrase change
ppddpassw [-m] ppdd_device file|disc_partition
-m change the master pass phrase
e.g. ppddpassw /dev/ppdd0 /dev/hda1
e.g. ppddpassw -m /dev/ppdd0 /dev/hda1
The default is to change the working pass phrase. If you change
the master pass phrase this will erase the working pass phrase too.
Note also that if there is a working pass phrase currently valid then
either of these phrases is equally valid to allow access to the various
functions which require pass phrase access.
Erasing the working phrase
See the documenation on the security of backups to find out more about
why this option exists.
ppddpassw -e ppdd_device file|disc_partition
Destroying all data
You may just want to do this one day!
Be warned that unless you have a suitable backup this is a totally
irreversible step.
ppddpassw -z ppdd_device file|disc_partition
Decrypt all the data
This is mainly intended if you decide to stop using ppdd and you want
to change the partition into a normal filesystem again. You should not
interupt the process as the decryption operates on the data "in-place"
and there are no restart points.
RETURN VALUE
The program returns 0 if everything worked as expected. That means that the
ppdd device has been successfully connected to the host device or file.
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)
ppddcsum(1)
ppdddown(1)
ppddinit(1)
ppddmchk(1)
ppddsetup(1)
ppdduprev(1)
ppdecrypt(1)
ppdncrypt(1)
ppddtab(5).
(c) 1999 Allan Latham - version 0.9
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- Pass phrase change
-
-
-
-
- Erasing the working phrase
-
-
- Destroying all data
-
-
-
- Decrypt all the data
-
- RETURN VALUE
-
- ERRORS
-
- ENVIRONMENT
-
- FILES
-
- SEE ALSO
-
-
This document was created by
man2html,
using the manual pages.
Time: 16:36:42 GMT, September 14, 1999