GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PFSTORE (1)

NAME

pfstore - Used to create and manage a pass-phrase store.

CONTENTS

Synopsis
Options
Description
Pfsfile Format
Examples
Security Considerations
Restrictions
See Also
Acknowledgments

SYNOPSIS

pfstore [-n] [-d] -f pfsfile identity

OPTIONS

-n Create the file
-d Delete given identity from the store
-f pfsfile
  Specifies file that holds identity/pass-phrase pairs

DESCRIPTION

pfstore is used to create and manage files that hold identity/pass-phrase pairs. It is primarily used to manage the owampd.pfs file for owampd.

If the -d option is not specified, then pfstore prompts the caller for a pass-phrase. The pass-phrase is hex-encoded and saved in the pfsfile with the associated identity. If the given identity already exists in the pfsfile, the previous pass-phrase is overwritten with the new one.

pfsfiles generated by pfstore are formatted for use with OWAMP.

PFSFILE FORMAT

pfstore generates lines of the format:

test    54b0c58c7ce9f2a8b551351102ee0938

An identity, followed by whitespace, followed by a variable-length hex-encoded pass-phrase.

No other text is allowed on these lines; however, comment lines may be added. Comment lines are any line where the first non-white space character is ’#’.

EXAMPLES

pfstore -f /usr/local/etc/owampd.pfs testuser
Adds a pass-phrase for the identity testuser. The user is prompted for a pass-phrase. If the file does not exist, an error message will be printed and no action will be taken.
pfstore -f /usr/local/etc/owampd.pfs -n testuser
Creates the file before doing the same as above. If the file already exists, an error message will be printed and no action will be taken.
pfstore -f /usr/local/etc/owampd.pfs -d testuser
Deletes the identity testuser from the pfsfile. If the file does not exist, an error message will be printed and no action will be taken.

SECURITY CONSIDERATIONS

The pass-phrases in the pfsfile are not encrypted in any way; they are simply hex-encoded. The security of these pass-phrases is completely dependent upon the security of the filesystem and the discretion of the system administrator.

RESTRICTIONS

identity names are restricted to 80 characters.

SEE ALSO

owping(1), owampd(1), owampd(1) and the  http://e2epi.internet2.edu/owamp web site.

ACKNOWLEDGMENTS

This material is based, in part, on work supported by the National Science Foundation (NSF) under Grant No. ANI-0314723. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the NSF.
Search for    or go to Top of page |  Section 1 |  Main Index


--> PFSTORE (1) $Date: 2007-02-01 14:51:00 -0500 (Thu, 01 Feb 2007) $

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.