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