OpenPKG Specs: openpkg/license.8@a2c6460cfb16 (annotated)

openpkg/license.8@a2c6460cfb16 (annotated)

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.

 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
 .de Sp \" Vertical space (when we can't use .PP)
 .if t .sp .5v
 .if n .sp
 ..
 .de Vb \" Begin verbatim text
 .ft CW
 .nf
 .ne \\$1
 ..
 .de Ve \" End verbatim text
 .ft R
 .fi
 ..
 .\" Set up some character translations and predefined strings.  \*(-- will
 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
 .\" nothing in troff, for use with C<>.
 .tr \(*W-
 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 .ie n \{\
 .    ds -- \(*W-
 .    ds PI pi
 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
 .    ds L" ""
 .    ds R" ""
 .    ds C`
 .    ds C'
 'br\}
 .el\{\
 .    ds -- \|\(em\|
 .    ds PI \(*p
 .    ds L" ``
 .    ds R" ''
 'br\}
 .\"
 .\" Escape single quotes in literal strings from groff's Unicode transform.
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .\"
 .\" If the F register is turned on, we'll generate index entries on stderr for
 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
 .\" entries marked with X<> in POD.  Of course, you'll have to process the
 .\" output yourself in some meaningful fashion.
 .ie \nF \{\
 .    de IX
 .    tm Index:\\$1\t\\n%\t"\\$2"
 ..
 .    nr % 0
 .    rr F
 .\}
 .el \{\
 .    de IX
 ..
 .\}
 .\"
 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 .    \" fudge factors for nroff and troff
 .if n \{\
 .    ds #H 0
 .    ds #V .8m
 .    ds #F .3m
 .    ds #[ \f1
 .    ds #] \fP
 .\}
 .if t \{\
 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 .    ds #V .6m
 .    ds #F 0
 .    ds #[ \&
 .    ds #] \&
 .\}
 .    \" simple accents for nroff and troff
 .if n \{\
 .    ds ' \&
 .    ds ` \&
 .    ds ^ \&
 .    ds , \&
 .    ds ~ ~
 .    ds /
 .\}
 .if t \{\
 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 .\}
 .    \" troff and (daisy-wheel) nroff accents
 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 .ds ae a\h'-(\w'a'u*4/10)'e
 .ds Ae A\h'-(\w'A'u*4/10)'E
 .    \" corrections for vroff
 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 .    \" for low resolution devices (crt and lpr)
 .if \n(.H>23 .if \n(.V>19 \
 \{\
 .    ds : e
 .    ds 8 ss
 .    ds o a
 .    ds d- d\h'-1'\(ga
 .    ds D- D\h'-1'\(hy
 .    ds th \o'bp'
 .    ds Th \o'LP'
 .    ds ae ae
 .    ds Ae AE
 .\}
 .rm #[ #] #H #V #F C
 .\" ========================================================================
 .\"
 .IX Title "LICENSE 8"
 .TH LICENSE 8 "OpenPKG" "LICENSE(8)" "OpenPKG"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
 .nh
 .SH "NAME"
 openpkg license \- OpenPKG License Utility
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 \&\fBopenpkg license\fR \fBhelp\fR
 .PP
 \&\fBopenpkg license\fR \fBinstall\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR
 .PP
 \&\fBopenpkg license\fR \fBupdate\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR
 .PP
 \&\fBopenpkg license\fR \fBuninstall\fR \fIid\fR
 .PP
 \&\fBopenpkg license\fR \fBactivate\fR \fIid\fR
 .PP
 \&\fBopenpkg license\fR \fBview\fR \fIid\fR
 .PP
 \&\fBopenpkg license\fR \fBlist\fR
 .PP
 \&\fBopenpkg license\fR \fBactive\fR
 .PP
 \&\fBopenpkg license\fR \fBsanity\fR
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
 The \fBopenpkg license\fR command is the maintenance utility for OpenPKG
 Framework licenses.
 .SH "COMMANDS"
 .IX Header "COMMANDS"
 .IP "\fBopenpkg license\fR \fBhelp\fR" 4
 .IX Item "openpkg license help"
 This command just displays a short usage help information.
 .ie n .IP "\fBopenpkg license\fR \fBinstall\fR \fIid\fR \fIfile\fR|\fIurl\fR|\*(C`\-\*(C'" 4
 .el .IP "\fBopenpkg license\fR \fBinstall\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR" 4
 .IX Item "openpkg license install id file|url|-"
 This command installs the license contained in \fIfile\fR or at \fIurl\fR or
 provided on \fIstdin\fR under the identifier \fIid\fR. The \fIid\fR can be an
 arbitrary string, but the convention is that \fIid\fR is a short upper-case
 identifier.
 .ie n .IP "\fBopenpkg license\fR \fBupdate\fR \fIid\fR \fIfile\fR|\fIurl\fR|\*(C`\-\*(C'" 4
 .el .IP "\fBopenpkg license\fR \fBupdate\fR \fIid\fR \fIfile\fR|\fIurl\fR|\f(CW\*(C`\-\*(C'\fR" 4
 .IX Item "openpkg license update id file|url|-"
 This command updates an already installed license with the license
 contained in \fIfile\fR or at \fIurl\fR or provided on \fIstdin\fR under the
 identifier \fIid\fR.
 .IP "\fBopenpkg license\fR \fBuninstall\fR \fIid\fR" 4
 .IX Item "openpkg license uninstall id"
 This command uninstalls the license which is installed under \fIid\fR.
 A license can be uninstalled only if it is not currently activated (see
 \&\fBopenpkg license activate\fR command).
 .IP "\fBopenpkg license\fR \fBactivate\fR \fIid\fR" 4
 .IX Item "openpkg license activate id"
 This command activates the license which is installed under \fIid\fR.
 Only one installed license can be active at any time, so this command
 implicitly deactivates the currently activate license.
 .IP "\fBopenpkg license\fR \fBview\fR \fIid\fR" 4
 .IX Item "openpkg license view id"
 This command shows the license which is installed under \fIid\fR.
 .IP "\fBopenpkg license\fR \fBlist\fR" 4
 .IX Item "openpkg license list"
 This command lists the identifiers of all installed licenses.
 .IP "\fBopenpkg license\fR \fBactive\fR" 4
 .IX Item "openpkg license active"
 This command outputs the identifier of the currently activated license.
 .IP "\fBopenpkg license\fR \fBsanity\fR" 4
 .IX Item "openpkg license sanity"
 This command sanity checks the current license configuration.
 .SH "FILES"
 .IX Header "FILES"
 .ie n .IP "\fI\fI@l_prefix\fI@/etc/license\fR" 4
 .el .IP "\fI\f(CI@l_prefix\fI@/etc/license\fR" 4
 .IX Item "@l_prefix@/etc/license"
 The name of the currently activated license file under
 \&\fI\f(CI@l_prefix\fI@/etc/license.d/\fR.
 .ie n .IP "\fI\fI@l_prefix\fI@/etc/license.d/*\fR" 4
 .el .IP "\fI\f(CI@l_prefix\fI@/etc/license.d/*\fR" 4
 .IX Item "@l_prefix@/etc/license.d/*"
 The directory containing all installed license files.
 .SH "HISTORY"
 .IX Header "HISTORY"
 The \fBopenpkg license\fR command first appeared in \fBOpenPKG 4.0\fR.

OpenPKG Specs / annotate

openpkg/license.8@a2c6460cfb16 (annotated)

openpkg/license.8