[go: up one dir, main page]

File: pfstore.man.html

package info (click to toggle)
i2util 1.2-1
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 1,048 kB
  • ctags: 456
  • sloc: ansic: 5,286; sh: 3,791; makefile: 48
file content (137 lines) | stat: -rw-r--r-- 4,201 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

<HTML><HEAD><TITLE>Manpage of pfstore</TITLE>
</HEAD><BODY>
<H1>pfstore</H1>
Section: User Commands  (1)<BR>Updated: $Date: 2007-02-01 14:51:00 -0500 (Thu, 01 Feb 2007) $<BR><A HREF="#index">Index</A>
<A HREF="../index.html">Return to Main Contents</A><HR>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

pfstore - Used to create and manage a pass-phrase store.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>pfstore </B>

[<I>-n</I>] [<I>-d</I>] <I>-f pfsfile identity
</I><A NAME="lbAD">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
<DT><B>-n</B><DD>
Create the file
<DT><B>-d</B><DD>
Delete given identity from the store
<DT><B>-f pfsfile</B><DD>
Specifies file that holds identity/pass-phrase pairs
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>DESCRIPTION</H2>

<B>pfstore</B>

is used to create and manage files that hold identity/pass-phrase pairs. It is
primarily used to manage the <I>owampd.pfs</I> file for <B>owampd</B>.
<P>

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

<I>pfsfiles</I> generated by <B>pfstore</B> are formatted for use with
<B>OWAMP</B>.
<A NAME="lbAF">&nbsp;</A>
<H2>PFSFILE FORMAT</H2>

<B>pfstore</B> generates lines of the format:
<P>

test<TT>&nbsp;&nbsp;&nbsp;</TT>54b0c58c7ce9f2a8b551351102ee0938<BR>
<P>

An <I>identity</I>, followed by whitespace, followed by a variable-length
hex-encoded pass-phrase.
<P>

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 '<B>#</B>'.
<A NAME="lbAG">&nbsp;</A>
<H2>EXAMPLES</H2>

<B>pfstore -f /usr/local/etc/owampd.pfs testuser</B>
<DL COMPACT>
<DT><DD>
Adds a pass-phrase for the identity <I>testuser</I>. 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.
</DL>
<P>

<B>pfstore -f /usr/local/etc/owampd.pfs -n testuser</B>
<DL COMPACT>
<DT><DD>
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.
</DL>
<P>

<B>pfstore -f /usr/local/etc/owampd.pfs -d testuser</B>
<DL COMPACT>
<DT><DD>
Deletes the identity <I>testuser</I> from the pfsfile.
If the file does not exist, an error message will be printed and no action will be taken.
</DL>
<P>

<A NAME="lbAH">&nbsp;</A>
<H2>SECURITY CONSIDERATIONS</H2>

The pass-phrases in the <I>pfsfile</I> 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.
<A NAME="lbAI">&nbsp;</A>
<H2>RESTRICTIONS</H2>

<I>identity</I> names are restricted to 80 characters.
<A NAME="lbAJ">&nbsp;</A>
<H2>SEE ALSO</H2>

<A HREF="owping.man.html">owping</A>(1), <A HREF="owampd.man.html">owampd</A>(1), <A HREF="owampd.man.html">owampd</A>(1)
and the <A HREF="http://e2epi.internet2.edu/owamp">http://e2epi.internet2.edu/owamp</A> web site.
<A NAME="lbAK">&nbsp;</A>
<H2>ACKNOWLEDGMENTS</H2>

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.
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">OPTIONS</A><DD>
<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
<DT><A HREF="#lbAF">PFSFILE FORMAT</A><DD>
<DT><A HREF="#lbAG">EXAMPLES</A><DD>
<DT><A HREF="#lbAH">SECURITY CONSIDERATIONS</A><DD>
<DT><A HREF="#lbAI">RESTRICTIONS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
<DT><A HREF="#lbAK">ACKNOWLEDGMENTS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 19:05:04 GMT, February 17, 2014
</BODY>
</HTML>