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

openpkg/register.8@a2c6460cfb16 (annotated)

openpkg/register.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 "REGISTER 8"
 .TH REGISTER 8 "OpenPKG" "REGISTER(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 register \- OpenPKG Registry Command\-Line Client
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 \&\fBregister\fR [\-u|\-\-user=<user|token>] [\-l|\-\-link=<token>] [\fI\-d|\-\-desc=<text\fR>]
           [\-m|\-\-mode=fake|post|wipe] [\fI\-a|\-\-args=<args\fR>]
           [\fI\-\-plat=<text\fR>] [\fI\-\-orel=<text\fR>] [\fI\-\-uuid=<file\fR>]
           [\fI\-\-conf=<file\fR>] [\fI\-\-prep=<file\fR>] [\fI\-\-tran=<file\fR>]
           [\fI\-\-util=<file\fR>] [\-\-data=<tag>[,<tag>...]]
           [\fI\-P|\-\-preparation\fR] [\fI\-T|\-\-transaction\fR]
           [\fI\-U|\-\-utilization\fR] [\fI\-C|\-\-convenience\fR]
           [\fI\-I|\-\-interaction\fR]
           [\fI\-v|\-\-verbose\fR] [\fI\-h|\-\-help\fR]
 .PP
 \&\fBregister\fR \-S|\-\-printstatus
 .PP
 \&\fBregister\fR \-R|\-\-rewriteurls [\fIurl\fR ...]
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
 \&\fBopenpkg register\fR is the Command-Line Client the OpenPKG Registry. It is
 used by administrators to register an instance with the OpenPKG Registry for
 later association.
 .PP
 After association, \fBopenpkg register\fR can be used for repetitive
 reregistrations which update the heartbeat of the instance on the Registry
 server, avoiding premature depature from the database. It is assumed that
 every instance will be reregistered daily. Dormant
 instances might be discarded from the Registry, revoking their access to
 additional resources.
 .SH "PRIMARY OPERATIONS"
 .IX Header "PRIMARY OPERATIONS"
 The following primary operations are available:
 .IP "\fB\-h\fR, \fB\-\-help\fR" 4
 .IX Item "-h, --help"
 Display brief usage message.
 .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
 .IX Item "-v, --verbose"
 Display progress information during data posting.
 .IP "\fB\-P\fR, \fB\-\-preparation\fR" 4
 .IX Item "-P, --preparation"
 Execute the primary operation \*(L"preparation\*(R".
 Creates registry data for one request and dumps it stdout
 in \s-1XML\s0 format. That request can be filtered and piped into
 the transaction phase or it can be copied and pasted into the
 XMLdump \s-1CGI\s0 facility manually.
 A copy of the output of the last run is also saved to the \f(CW\*(C`${REGISTRY_PREP}\*(C'\fR file.
 .IP "\fB\-T\fR, \fB\-\-transaction\fR" 4
 .IX Item "-T, --transaction"
 Execute the primary operation \*(L"transaction\*(R".
 Reads registry data with one request from stdin, executes
 the transaction and writes registry data with one or more
 responses to stdout in \s-1XML\s0 format.
 Depending on the mode of operation, the transaction might be an actual
 transport to the XMLdump \s-1CGI\s0 facility or a fake activity which complements the
 manual preparation.
 A copy of the output of the last run is also saved to the \f(CW\*(C`${REGISTRY_TRAN}\*(C'\fR file.
 .IP "\fB\-U\fR, \fB\-\-utilization\fR" 4
 .IX Item "-U, --utilization"
 Execute the primary operation \*(L"utilization\*(R".
 Reads registry data with one response from stdin and updates the local
 registry information.
 Depending on the mode of operation, the utilization might be an actual
 processing of a transaction response or a fake activity which complements the
 manual transaction.
 Anyway, this step finalizes the registration process and makes the instance
 assume it has been properly registered. This status can be printed. \s-1URL\s0
 rewriting is activated.
 A copy of the output of the last run is also saved to the \f(CW\*(C`${REGISTRY_UTIL}\*(C'\fR file.
 .IP "\fB\-C\fR, \fB\-\-convenience\fR" 4
 .IX Item "-C, --convenience"
 Execute the primary operation \*(L"convenience\*(R".
 This executes the three primary operations \*(L"preparation\*(R", \*(L"transaction\*(R" and
 \&\*(L"utilization\*(R" in that order and pipes data through this chain.
 .IP "\fB\-I\fR, \fB\-\-interaction\fR" 4
 .IX Item "-I, --interaction"
 Execute the primary operation \*(L"interaction\*(R".
 Like \*(L"convenience\*(R" but user is interactively asked for information. This is
 the easiest way to do registration but it is not meat to be automated.
 .IP "\fB\-S\fR, \fB\-\-printstatus\fR" 4
 .IX Item "-S, --printstatus"
 If the instance has been registered, information about the registration is printed in a
 format suitable for shell evaluation and return code is true.
 Otherwise nothing is printed and return code is false.
 .IP "\fB\-R\fR, \fB\-\-rewriteurls\fR [\fIurl\fR ...]" 4
 .IX Item "-R, --rewriteurls [url ...]"
 If the instance has been registered, the given URLs are rewritten to prepend
 user:pass information before hostnames below the openpkg.(org|net|com)
 domains.  Note the username is is \s-1UUID_REGISTRY\s0 and the password is the
 concatenation of \s-1UUID_INSTANCE\s0 and \s-1UUID_PLATFORM\s0 from the
 PREFIX/etc/openpkg/uuid file. Both informations are not meant to be used for
 traditional authentication, they are merly statistical information.
 Otherwise the URLs are returned verbatim.
 .SH "STANDARD OPTIONS"
 .IX Header "STANDARD OPTIONS"
 Standard options are typically used to automate registration (not
 association).
 .IP "\fB\-m\fR, \fB\-\-mode\fR fake|post|wipe" 4
 .IX Item "-m, --mode fake|post|wipe"
 Overrides \f(CW\*(C`${REGISTRY_MODE}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Has no default and is a manadatory setting.
 .Sp
 In \fBpost\fR mode, transactions are carried out using real network connectivity.
 The \*(L"preparation\*(R" step creates a XMLdump and writes it into the
 \&\f(CW\*(C`${REGISTRY_PREP}\*(C'\fR file. The \*(L"transaction\*(R" step posts it to the DropXML form
 using a \s-1HTTP\s0 request. The response coming back from Registration server is
 also in \s-1XML\s0 format and is saved to  \f(CW\*(C`${REGISTRY_TRAN}\*(C'\fR file.  The
 \&\*(L"utilization\*(R" step processes this response and writes the final results to the
 \&\f(CW\*(C`${REGISTRY_UTIL}\*(C'\fR file.
 .Sp
 In \fBfake\fR mode, no network connectivity takes place.
 The \*(L"prepararation\*(R" step creates a XMLdump and writes it into the
 \&\f(CW\*(C`${REGISTRY_PREP}\*(C'\fR file. The \*(L"transaction\*(R" step is a fake only. It assumes a
 successful response from the Registration server and saves it to
 \&\f(CW\*(C`${REGISTRY_TRAN}\*(C'\fR file.  The \*(L"utilization\*(R" step processes this response and
 writes the final results to the \f(CW\*(C`${REGISTRY_UTIL}\*(C'\fR file.
 \&\fINote\fR: fake mode is meant as a way to register instances which cannot or must
 not post data directly to the Registration server.
 .Sp
 In \fBwipe\fR mode, the registration is wiped out locally. The status is reset
 and \s-1URL\s0 rewriting is disabled.
 \&\fINote\fR: the registration server is not contacted, the instace must be removed
 manually using the web interface.
 \&\fINote\fR: wiping registration is highly recommended as a precursor action of
 cloning activities.
 .ie n .IP "\fB\-a\fR, \fB\-\-args\fR ""arg [arg ...]""" 4
 .el .IP "\fB\-a\fR, \fB\-\-args\fR ``arg [arg ...]''" 4
 .IX Item "-a, --args arg [arg ...]"
 Overrides \f(CW\*(C`${REGISTRY_ARGS}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Complements the mode and is specific to it.
 Defaults to \*(L"http://registry.openpkg.org/register\*(R" which is the official registry of the OpenPKG Project.
 This default is useful for \*(L"post\*(R" mode.
 .IP "\fB\-u\fR, \fB\-\-user\fR \fIuser|token\fR" 4
 .IX Item "-u, --user user|token"
 Overrides \f(CW\*(C`${REGISTRY_USER}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Indicates the registry user which will find this registration in his arrival queue.
 The user can also specified as a token which is enabled for use as \*(L"user\*(R".
 If the token is also enabled for \*(L"assoc\*(R" the registered instance is immediately associated
 to the user with no need for the user to visit the web interface.
 This information in submitted via the \*(L"registry_user\*(R" attribute of the \s-1XML\s0 request.
 Retrieves default online from http://openpkg.org/go/autoregister and is a manadatory setting.
 .IP "\fB\-l\fR, \fB\-\-link\fR \fItoken\fR" 4
 .IX Item "-l, --link token"
 Overrides \f(CW\*(C`${REGISTRY_LINK}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Indicates the registry user which will find this registration linked to his token.
 The link must be specified as a token which is enabled for use as \*(L"link\*(R".
 If a user token is used and the link token is also enabled for \*(L"assoc\*(R" then the registered instance
 is immediately associated to the user with no need for the user to visit the web interface.
 This information in submitted via the \*(L"registry_link\*(R" attribute of the \s-1XML\s0 request.
 Has no default and is an optional setting.
 Be aware that linked users see the same information about an instance as the associated user
 can find on his \*(L"association\*(R" page but they cannot alter or delete information.
 .IP "\fB\-d\fR, \fB\-\-desc\fR \fIdescription\fR" 4
 .IX Item "-d, --desc description"
 Overrides \f(CW\*(C`${REGISTRY_DESC}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Indicates a human readable description of the instance.
 This information in submitted via the \*(L"registry_desc\*(R" attribute of the \s-1XML\s0 request.
 It appears in the \*(L"description\*(R" column on the \*(L"association\*(R" page of the web form and can be edited on the server side.
 Defaults to \*(L"openpkg://${\s-1FQDN\s0}${\s-1PREFIX\s0}\*(R"
 .SH "ADVANCED OPTIONS"
 .IX Header "ADVANCED OPTIONS"
 Advanced options can be enganged to tailor and fully automate a registration
 (not association).
 .IP "\fB\-\-plat\fR" 4
 .IX Item "--plat"
 Overrides \f(CW\*(C`${REGISTRY_PLAT}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Indicates the platform. Concatenated information from \s-1CPU\s0 architecture (arch) and Operating System (os).
 This information in submitted via the \*(L"registry_plat\*(R" attribute of the \s-1XML\s0 request.
 Defaults to \*(L"%{l_platform \-p}\*(R", e.g. \*(L"ix86\-freebsd6.1\*(R"
 .IP "\fB\-\-orel\fR" 4
 .IX Item "--orel"
 Overrides \f(CW\*(C`${REGISTRY_VERS}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Indicates the OpenPKG release.
 This information in submitted via the \*(L"registry_orel\*(R" attribute of the \s-1XML\s0 request.
 Defaults to \*(L"%{l_openpkg_release}\*(R", e.g. \*(L"OpenPKG-CURRENT\*(R", \*(L"OpenPKG\-2\-STABLE\*(R", \*(L"OpenPKG\-2.5\*(R",
 .IP "\fB\-\-uuid\fR" 4
 .IX Item "--uuid"
 Overrides \f(CW\*(C`${REGISTRY_UUID}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Indicates the \s-1UUID\s0 file of the instance.
 This information in submitted via the \*(L"uuid_registry\*(R", \*(L"uuid_instance\*(R" and \*(L"uuid_platform\*(R" attributes of the \s-1XML\s0 request.
 Defaults to \fI${\s-1PREFIX\s0}/etc/openpkg/uuid\fR
 .IP "\fB\-\-conf\fR" 4
 .IX Item "--conf"
 Overrides \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR variable from previous \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file. Processing
 of the current configuration file is aborted immediately with all variables
 read so far kept. THe new configuration file is read in immediately and
 processing continues there. This works similar to an include but is more
 primitive as it does not allow nesting, only chaining.
 Defaults to \fI${\s-1PREFIX\s0}/etc/openpkg/register.conf\fR
 .IP "\fB\-\-prep\fR" 4
 .IX Item "--prep"
 Overrides \f(CW\*(C`${REGISTRY_PREP}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 File to save a copy of the output from the \*(L"preparation\*(R" step.
 Defaults to \fI${\s-1PREFIX\s0}/etc/openpkg/register.prep\fR
 .IP "\fB\-\-tran\fR" 4
 .IX Item "--tran"
 Overrides \f(CW\*(C`${REGISTRY_TRAN}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 File to save a copy of the output from the \*(L"transaction\*(R" step.
 Defaults to \fI${\s-1PREFIX\s0}/etc/openpkg/register.tran\fR
 .IP "\fB\-\-util\fR" 4
 .IX Item "--util"
 Overrides \f(CW\*(C`${REGISTRY_UTIL}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 File to save a copy of the output from the \*(L"utilization\*(R" step.
 Defaults to \fI${\s-1PREFIX\s0}/etc/openpkg/register.util\fR
 .IP "\fB\-\-data\fR" 4
 .IX Item "--data"
 Overrides \f(CW\*(C`${REGISTRY_DATA}\*(C'\fR variable in \f(CW\*(C`${REGISTRY_CONF}\*(C'\fR file.
 Comma separated list of tags to prepare. Available tags are \*(L"request\*(R",
 \&\*(L"package\*(R" and \*(L"provides\*(R". The \*(L"request\*(R" refers to the whole thing and
 is mandatory. The \*(L"package\*(R" includes name-version-release information
 for all installed packages and \*(L"provides\*(R" adds more details required to
 capture package options. For details see \s-1OPENPKG_PREP\s0 below.
 Defaults to \*(L"request,package,provides\*(R"
 .SH "FILES"
 .IX Header "FILES"
 The following files are used by \fBopenpkg register\fR:
 .IP "OPENPKG_UUID=\fI${\s-1PREFIX\s0}/etc/openpkg/uuid\fR" 4
 .IX Item "OPENPKG_UUID=${PREFIX}/etc/openpkg/uuid"
 .Vb 3
 \& UUID_REGISTRY="..."
 \& UUID_INSTANCE="..."
 \& UUID_PLATFORM="..."
 .Ve
 .IP "OPENPKG_CONF=\fI${\s-1PREFIX\s0}/etc/openpkg/register.conf\fR" 4
 .IX Item "OPENPKG_CONF=${PREFIX}/etc/openpkg/register.conf"
 Format suitable for shell evaluation. Interactive mode appends remarked date
 and current settings for reuse as new defaults for future runs. Can be preset
 to customize or automate registration.
 .IP "OPENPKG_PREP=\fI${\s-1PREFIX\s0}/etc/openpkg/register.prep\fR" 4
 .IX Item "OPENPKG_PREP=${PREFIX}/etc/openpkg/register.prep"
 .Vb 10
 \& <?xml version="1.0" encoding="iso\-8859\-1" standalone="no"?>
 \& <!DOCTYPE registry
 \&   PUBLIC "\-//OpenPKG//DTD OpenPKG Registry 0.0.1//EN"
 \&   "http://registry.openpkg.org/registry.dtd" []>
 \& <registry>
 \&     <request id="..."
 \&         registry_user="me@example.com"
 \&         registry_desc="openpkg://rm0.openpkg.net/openpkg\-dev"
 \&         registry_plat="ix86\-freebsd6.1"
 \&         registry_orel="OpenPKG\-CURRENT"
 \&         uuid_registry="..."
 \&         uuid_instance="..."
 \&         uuid_platform="..."
 \&     />
 \&     <package id="..." name="ssmtp" version="2.61" release="20050608">
 \&        <provides name="ssmtp::with_ssl" flag="=" version="no"/>
 \&        <provides name="MTA" flag="" version=""/>
 \&        <provides name="ssmtp" flag="=" version="2.61\-20050608"/>
 \&     </package>
 \& </registry>
 .Ve
 .Sp
 The \s-1XML\s0 request starts with <?xml version ...> and <!DOCTYPE registry ...>
 headers followed by a <registry> container. The request is inside a <request>
 tag. Successful submission into the XMLdump form requires the headers and
 exactly one container. It is possible to merge multiple requests into a single
 container manually or otherwise and submit them all at once.
 .IP "OPENPKG_TRAN=\fI${\s-1PREFIX\s0}/etc/openpkg/register.tran\fR" 4
 .IX Item "OPENPKG_TRAN=${PREFIX}/etc/openpkg/register.tran"
 .Vb 7
 \& <?xml version="1.0" encoding="iso\-8859\-1" standalone="no"?>
 \& <!DOCTYPE registry
 \&   PUBLIC "\-//OpenPKG//DTD OpenPKG Registry 0.0.1//EN"
 \&   "http://registry.openpkg.org/registry.dtd" []>
 \& <registry>
 \&     <response id="..." done="yes">openpkg://rm0.openpkg.net/openpkg\-dev</response>
 \& </registry>
 .Ve
 .Sp
 The \s-1XML\s0 response starts with <?xml version ...> and <!DOCTYPE registry ...>
 headers followed by a <registry> container. The response is inside a <request>
 tag. The data carried in the tag comes from the \*(L"description\*(R" column on the
 \&\*(L"association\*(R" page of the web form and can be edited on the server side.
 .IP "OPENPKG_UTIL=\fI${\s-1PREFIX\s0}/etc/openpkg/register.util\fR" 4
 .IX Item "OPENPKG_UTIL=${PREFIX}/etc/openpkg/register.util"
 .Vb 3
 \& REGISTRY_DBID="..."
 \& REGISTRY_DONE="yes"
 \& REGISTRY_RESP="openpkg://foo.example.com/my/openpkg/prefix"
 .Ve
 .SH "EXAMPLES"
 .IX Header "EXAMPLES"
 .Vb 10
 \& # su \- openpkg\-mop
 \& $ openpkg register \-\-printstatus
 \& REGISTRY_DBID="..."
 \& REGISTRY_DONE="yes"
 \& REGISTRY_RESP="openpkg://foo.example.com/my/openpkg/prefix"
 \& $ openpkg register \-\-printstatus >/dev/null && echo "Yup"
 \& Yup
 \& $ eval \`openpkg register \-\-printstatus\`; echo DONE=$REGISTRY_DONE
 \& DONE=yes
 \& $ openpkg register \-\-mode=wipe
 \& $ openpkg register \-\-printstatus || echo "Nope"
 \& Nope
 \& $ openpkg register \-\-user=thl@openpkg.net \-\-mode=post
 \& REGISTRY_DBID="...."
 \& REGISTRY_DONE="yes"
 \& REGISTRY_RESP="openpkg://foo.example.com/my/openpkg/prefix"
 \& $ openpkg register \-\-printstatus >/dev/null && echo "Yup"
 \& Yup
 \& $ openpkg register \-\-rewriteurls http://download.openpkg.org/foo/bar
 \& ftp://...:...@download.openpkg.org/foo/bar
 .Ve
 .SH "SEE ALSO"
 .IX Header "SEE ALSO"
 \&\fIbash\fR\|(1), \f(CW\*(C`openpkg man uuid\*(C'\fR, \f(CW\*(C`http://registry.openpkg.org/\*(C'\fR
 .SH "AUTHOR"
 .IX Header "AUTHOR"
 Thomas Lotterer <thl@openpkg.org>

OpenPKG Specs / annotate

openpkg/register.8@a2c6460cfb16 (annotated)

openpkg/register.8