openpkg/license.8@a2c6460cfb16
openpkg/license.8
Mon, 28 Jan 2013 17:37:18 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Mon, 28 Jan 2013 17:37:18 +0100
- changeset 758
- a2c6460cfb16
- permissions
- -rw-r--r--
Correct socket error reporting improvement with IPv6 portable code,
after helpful recommendation by Saúl Ibarra Corretgé on OSips devlist.
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C`
34 . ds C'
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 . de IX
53 . tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 . nr % 0
56 . rr F
57 .\}
58 .el \{\
59 . de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
65 . \" fudge factors for nroff and troff
66 .if n \{\
67 . ds #H 0
68 . ds #V .8m
69 . ds #F .3m
70 . ds #[ \f1
71 . ds #] \fP
72 .\}
73 .if t \{\
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 . ds #V .6m
76 . ds #F 0
77 . ds #[ \&
78 . ds #] \&
79 .\}
80 . \" simple accents for nroff and troff
81 .if n \{\
82 . ds ' \&
83 . ds ` \&
84 . ds ^ \&
85 . ds , \&
86 . ds ~ ~
87 . ds /
88 .\}
89 .if t \{\
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 . \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 . \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 . \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 . ds : e
114 . ds 8 ss
115 . ds o a
116 . ds d- d\h'-1'\(ga
117 . ds D- D\h'-1'\(hy
118 . ds th \o'bp'
119 . ds Th \o'LP'
120 . ds ae ae
121 . ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "LICENSE 8"
127 .TH LICENSE 8 "OpenPKG" "LICENSE(8)" "OpenPKG"
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 openpkg license \- OpenPKG License Utility
134 .SH "SYNOPSIS"
135 .IX Header "SYNOPSIS"
136 \&\fBopenpkg license\fR \fBhelp\fR
137 .PP
138 \&\fBopenpkg license\fR \fBinstall\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR
139 .PP
140 \&\fBopenpkg license\fR \fBupdate\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR
141 .PP
142 \&\fBopenpkg license\fR \fBuninstall\fR \fIid\fR
143 .PP
144 \&\fBopenpkg license\fR \fBactivate\fR \fIid\fR
145 .PP
146 \&\fBopenpkg license\fR \fBview\fR \fIid\fR
147 .PP
148 \&\fBopenpkg license\fR \fBlist\fR
149 .PP
150 \&\fBopenpkg license\fR \fBactive\fR
151 .PP
152 \&\fBopenpkg license\fR \fBsanity\fR
153 .SH "DESCRIPTION"
154 .IX Header "DESCRIPTION"
155 The \fBopenpkg license\fR command is the maintenance utility for OpenPKG
156 Framework licenses.
157 .SH "COMMANDS"
158 .IX Header "COMMANDS"
159 .IP "\fBopenpkg license\fR \fBhelp\fR" 4
160 .IX Item "openpkg license help"
161 This command just displays a short usage help information.
162 .ie n .IP "\fBopenpkg license\fR \fBinstall\fR \fIid\fR \fIfile\fR|\fIurl\fR|\*(C`\-\*(C'" 4
163 .el .IP "\fBopenpkg license\fR \fBinstall\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR" 4
164 .IX Item "openpkg license install id file|url|-"
165 This command installs the license contained in \fIfile\fR or at \fIurl\fR or
166 provided on \fIstdin\fR under the identifier \fIid\fR. The \fIid\fR can be an
167 arbitrary string, but the convention is that \fIid\fR is a short upper-case
168 identifier.
169 .ie n .IP "\fBopenpkg license\fR \fBupdate\fR \fIid\fR \fIfile\fR|\fIurl\fR|\*(C`\-\*(C'" 4
170 .el .IP "\fBopenpkg license\fR \fBupdate\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR" 4
171 .IX Item "openpkg license update id file|url|-"
172 This command updates an already installed license with the license
173 contained in \fIfile\fR or at \fIurl\fR or provided on \fIstdin\fR under the
174 identifier \fIid\fR.
175 .IP "\fBopenpkg license\fR \fBuninstall\fR \fIid\fR" 4
176 .IX Item "openpkg license uninstall id"
177 This command uninstalls the license which is installed under \fIid\fR.
178 A license can be uninstalled only if it is not currently activated (see
179 \&\fBopenpkg license activate\fR command).
180 .IP "\fBopenpkg license\fR \fBactivate\fR \fIid\fR" 4
181 .IX Item "openpkg license activate id"
182 This command activates the license which is installed under \fIid\fR.
183 Only one installed license can be active at any time, so this command
184 implicitly deactivates the currently activate license.
185 .IP "\fBopenpkg license\fR \fBview\fR \fIid\fR" 4
186 .IX Item "openpkg license view id"
187 This command shows the license which is installed under \fIid\fR.
188 .IP "\fBopenpkg license\fR \fBlist\fR" 4
189 .IX Item "openpkg license list"
190 This command lists the identifiers of all installed licenses.
191 .IP "\fBopenpkg license\fR \fBactive\fR" 4
192 .IX Item "openpkg license active"
193 This command outputs the identifier of the currently activated license.
194 .IP "\fBopenpkg license\fR \fBsanity\fR" 4
195 .IX Item "openpkg license sanity"
196 This command sanity checks the current license configuration.
197 .SH "FILES"
198 .IX Header "FILES"
199 .ie n .IP "\fI\fI@l_prefix\fI@/etc/license\fR" 4
200 .el .IP "\fI\f(CI@l_prefix\fI@/etc/license\fR" 4
201 .IX Item "@l_prefix@/etc/license"
202 The name of the currently activated license file under
203 \&\fI\f(CI@l_prefix\fI@/etc/license.d/\fR.
204 .ie n .IP "\fI\fI@l_prefix\fI@/etc/license.d/*\fR" 4
205 .el .IP "\fI\f(CI@l_prefix\fI@/etc/license.d/*\fR" 4
206 .IX Item "@l_prefix@/etc/license.d/*"
207 The directory containing all installed license files.
208 .SH "HISTORY"
209 .IX Header "HISTORY"
210 The \fBopenpkg license\fR command first appeared in \fBOpenPKG 4.0\fR.
