OpenPKG Specs: openpkg/release.8@c10fb90893b9

Correct out of date build configuration, porting to Solaris 11 network
link infrastructure and new libpcap logic. This additionally allows for
device drivers in subdirectories of /dev. Correct packaged nmap
personalities and signatures to work out of the box. Finally, hack
arpd logic to properly close sockets and quit on TERM by repeating
signaling in the run command script. Sadly, all this fails to correct
the run time behaviour of honeyd which fails to bind to the IP layer.

     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 "RELEASE 8"

   127 .TH RELEASE 8 "OpenPKG" "RELEASE(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 release \- OpenPKG Release Utility

   134 .SH "SYNOPSIS"

   135 .IX Header "SYNOPSIS"

   136 \&\fBopenpkg release\fR [\fB\-F\fR|\fB\-\-fmt\fR \fIformat\fR]

   137 .SH "DESCRIPTION"

   138 .IX Header "DESCRIPTION"

   139 The \fBopenpkg release\fR command displays the OpenPKG release tag and

   140 distribution \s-1URL\s0. The release tag uniquely identifies an OpenPKG

   141 distribution and the distribution \s-1URL\s0 is the location where the

   142 distribution packages and indices are stored.

   143 .SH "OPTIONS"

   144 .IX Header "OPTIONS"

   145 .IP "\fB\-F\fR, \fB\-\-fmt\fR \fIformat\fR" 4

   146 .IX Item "-F, --fmt format"

   147 The output format specification. The argument \fIformat\fR is an arbitrary

   148 string which can contain the special expansion constructs "\f(CW%t\fR\*(L" for

   149 expanding the release tag, \*(R"\f(CW%u\fR\*(L" for expanding the distribution \s-1URL\s0

   150 and \*(R"\f(CW\*(C`\en\*(C'\fR" for expanding an embedded newline character.

   151 The instance \s-1UUID\s0 information is also availble by expanding

   152 \&\f(CW%r\fR to \s-1UUID_REGISTRY\s0, \f(CW%i\fR to \s-1UUID_INSTANCE\s0, \f(CW%p\fR to \s-1UUID_PLATFORM\s0.

   153 The default \fIformat\fR is "\f(CW\*(C`OpenPKG\-%t %u\*(C'\fR".

   154 .IP "\fB\-r\fR, \fB\-\-release\fR \fIrelease\fR" 4

   155 .IX Item "-r, --release release"

   156 The package "\f(CW\*(C`Release\*(C'\fR" header value to use for deriving the release

   157 tag. The values in the \fI\f(CI@l_prefix\fI@/etc/openpkg/release\fR file and the

   158 "\f(CW\*(C`Release\*(C'\fR" header of the bootstrap package \fBopenpkg\fR are ignored if

   159 this option is used.

   160 .SH "FILES"

   161 .IX Header "FILES"

   162 .ie n .IP "\fI\fI@l_prefix\fI@/etc/openpkg/release\fR" 4

   163 .el .IP "\fI\f(CI@l_prefix\fI@/etc/openpkg/release\fR" 4

   164 .IX Item "@l_prefix@/etc/openpkg/release"

   165 This optional configuration file can be used to explicitly set values

   166 for the OpenPKG release tag and distribution URLs. It consists of lines

   167 with variable name/value pairs. The following configuration variables

   168 are recognized:

   169 .RS 4

   170 .IP "\fBTAG=\fR\fItag\fR" 4

   171 .IX Item "TAG=tag"

   172 The default \fItag\fR is automatically derived from the "\f(CW\*(C`Version\*(C'\fR" header

   173 of the OpenPKG bootstrap package \fBopenpkg\fR. One usually only sets this

   174 explicitly to a value if a bootstrap package is used from a foreign

   175 distribution version.

   176 .IP "\fBURL=\fR\fIurl\fR" 4

   177 .IX Item "URL=url"

   178 The fully-qualified distribution \s-1URL\s0 based on either the "\f(CW\*(C`ftp\*(C'\fR\*(L",

   179 \&\*(R"\f(CW\*(C`http\*(C'\fR\*(L" or \*(R"\f(CW\*(C`file\*(C'\fR" \s-1URL\s0 schemes. If \fIurl\fR contains a trailing

   180 "\f(CW\*(C`/*\*(C'\fR", this is expanded according to the \fItag\fR value of the \fB\s-1TAG\s0\fR

   181 variable and the corresponding filesystem layout on \f(CW\*(C`download.openpkg.org\*(C'\fR.

   182 The default \fIurl\fR is "\f(CW\*(C`http://download.openpkg.org/stacks/*\*(C'\fR".

   183 .RE

   184 .RS 4

   185 .RE

   186 .SH "EXAMPLE"

   187 .IX Header "EXAMPLE"

   188 .Vb 2

   189 \& $ openpkg release

   190 \& OpenPKG\-CURRENT http://download.openpkg.org/stacks/current/

   191 \&

   192 \& $ openpkg release \-\-fmt=%t

   193 \& CURRENT

   194 \&

   195 \& $ openpkg release \-\-fmt=%u

   196 \& http://download.openpkg.org/stacks/current/

   197 \&

   198 \& $ openpkg release \-\-fmt="OpenPKG %t is located at:\e\en%u"

   199 \& OpenPKG CURRENT is located at:

   200 \& http://download.openpkg.org/stacks/current/

   201 \&

   202 \& $ openpkg release \-\-release=2.5.4 \-\-fmt=%t

   203 \& 2.5\-RELEASE

   204 \&

   205 \& $ cat /openpkg/etc/openpkg/release

   206 \& TAG=CURRENT

   207 \& URL=http://download.example.com/stack/current/

   208 .Ve

   209 .SH "SEE ALSO"

   210 .IX Header "SEE ALSO"

   211 \&\fIuuid\fR\|(8)

   212 .SH "HISTORY"

   213 .IX Header "HISTORY"

   214 The \fBopenpkg release\fR command first appeared in \fBOpenPKG 2\-STABLE\-20060622\fR.

OpenPKG Specs / file revision

openpkg/release.8@c10fb90893b9

openpkg/release.8