OpenPKG Specs: openpkg/sea.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 "SEA 8"

   127 .TH SEA 8 "OpenPKG" "SEA(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 sea \- Shell Execution Archive

   134 .SH "SYNOPSIS"

   135 .IX Header "SYNOPSIS"

   136 \&\fBsea\fR

   137 [\fB\-h\fR|\fB\-\-help\fR]

   138 [\fB\-o\fR|\fB\-\-output\fR \fIsea\fR]

   139 \&\fIscript\fR

   140 [\fIfile-or-dir\fR ...]

   141 .SH "DESCRIPTION"

   142 .IX Header "DESCRIPTION"

   143 The \fBsea\fR utility allows you to wrap a control shell script (\fIscript\fR)

   144 plus zero or more payload file or directories (\fIfile-or-dir\fR) into a

   145 so-called \fIShell Execution Archive\fR (\fIsea\fR), a \fIsh\fR\|(1) executable script

   146 which temporarily auto-extracts its payload and pass-through execution

   147 to the control script.

   148 .SH "OPTIONS AND ARGUMENTS"

   149 .IX Header "OPTIONS AND ARGUMENTS"

   150 .IP "\fB\-h\fR|\fB\-\-help\fR" 4

   151 .IX Item "-h|--help"

   152 Just shows a short usage information of the \fBsea\fR utility.

   153 .IP "\fB\-o\fR|\fB\-\-output\fR \fIsea\fR" 4

   154 .IX Item "-o|--output sea"

   155 The output \fIShell Execution Archive\fR file. By default the output is

   156 saved to a file with a basename derived from \fIscript\fR and with new

   157 attached extension \fI.sea\fR.

   158 .IP "\fIscript\fR" 4

   159 .IX Item "script"

   160 The mandatory control script which is added to the payload and which

   161 (after auto-extraction) is executed. It receives all command-line

   162 arguments originally passed to the \fIShell Execution Archive\fR.

   163 .IP "\fIfile-or-dir\fR" 4

   164 .IX Item "file-or-dir"

   165 Optional number of files or directories which are added to the payload.

   166 .SH "EXAMPLES"

   167 .IX Header "EXAMPLES"

   168 .Vb 1

   169 \& $ sea \-o foo.src.sh foo.sh foo.src.d

   170 .Ve

   171 .SH "HISTORY"

   172 .IX Header "HISTORY"

   173 The \fBsea\fR command was implemented in April 2012 by \fIRalf S. Engelschall\fR

   174 <rse@engelschall.com>. Its idea is based on the

   175 OpenPKG shell packages (\fIopenpkg.src.sh\fR) and its implemenation was

   176 triggered by the demand for self-contained OpenPKG software stack source

   177 archives.

OpenPKG Specs / file revision

openpkg/sea.8@c10fb90893b9

openpkg/sea.8