openpkg/release.pod@a2c6460cfb16 (annotated)
openpkg/release.pod
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
- parent 13
- cb59d6afeb61
- permissions
- -rw-r--r--
Correct socket error reporting improvement with IPv6 portable code,
after helpful recommendation by Saúl Ibarra Corretgé on OSips devlist.
| michael@13 | 1 | ## |
| michael@13 | 2 | ## release -- OpenPKG Release Utility |
| michael@428 | 3 | ## Copyright (c) 2000-2012 OpenPKG GmbH <http://openpkg.com/> |
| michael@13 | 4 | ## |
| michael@428 | 5 | ## This software is property of the OpenPKG GmbH, DE MUC HRB 160208. |
| michael@428 | 6 | ## All rights reserved. Licenses which grant limited permission to use, |
| michael@428 | 7 | ## copy, modify and distribute this software are available from the |
| michael@428 | 8 | ## OpenPKG GmbH. |
| michael@13 | 9 | ## |
| michael@428 | 10 | ## THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED |
| michael@13 | 11 | ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
| michael@13 | 12 | ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| michael@13 | 13 | ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR |
| michael@13 | 14 | ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| michael@13 | 15 | ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| michael@13 | 16 | ## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF |
| michael@13 | 17 | ## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
| michael@13 | 18 | ## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| michael@13 | 19 | ## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT |
| michael@13 | 20 | ## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| michael@13 | 21 | ## SUCH DAMAGE. |
| michael@13 | 22 | ## |
| michael@13 | 23 | |
| michael@13 | 24 | =pod |
| michael@13 | 25 | |
| michael@13 | 26 | =head1 NAME |
| michael@13 | 27 | |
| michael@13 | 28 | B<openpkg release> - OpenPKG Release Utility |
| michael@13 | 29 | |
| michael@13 | 30 | =head1 SYNOPSIS |
| michael@13 | 31 | |
| michael@13 | 32 | B<openpkg release> [B<-F>|B<--fmt> I<format>] |
| michael@13 | 33 | |
| michael@13 | 34 | =head1 DESCRIPTION |
| michael@13 | 35 | |
| michael@13 | 36 | The B<openpkg release> command displays the OpenPKG release tag and |
| michael@13 | 37 | distribution URL. The release tag uniquely identifies an OpenPKG |
| michael@13 | 38 | distribution and the distribution URL is the location where the |
| michael@13 | 39 | distribution packages and indices are stored. |
| michael@13 | 40 | |
| michael@13 | 41 | =head1 OPTIONS |
| michael@13 | 42 | |
| michael@13 | 43 | =over 4 |
| michael@13 | 44 | |
| michael@13 | 45 | =item B<-F>, B<--fmt> I<format> |
| michael@13 | 46 | |
| michael@13 | 47 | The output format specification. The argument I<format> is an arbitrary |
| michael@13 | 48 | string which can contain the special expansion constructs "C<%t>" for |
| michael@13 | 49 | expanding the release tag, "C<%u>" for expanding the distribution URL |
| michael@428 | 50 | and "C<\n>" for expanding an embedded newline character. |
| michael@13 | 51 | The instance UUID information is also availble by expanding |
| michael@13 | 52 | C<%r> to UUID_REGISTRY, C<%i> to UUID_INSTANCE, C<%p> to UUID_PLATFORM. |
| michael@13 | 53 | The default I<format> is "C<OpenPKG-%t %u>". |
| michael@13 | 54 | |
| michael@13 | 55 | =item B<-r>, B<--release> I<release> |
| michael@13 | 56 | |
| michael@13 | 57 | The package "C<Release>" header value to use for deriving the release |
| michael@13 | 58 | tag. The values in the F<@l_prefix@/etc/openpkg/release> file and the |
| michael@13 | 59 | "C<Release>" header of the bootstrap package B<openpkg> are ignored if |
| michael@13 | 60 | this option is used. |
| michael@13 | 61 | |
| michael@13 | 62 | =back |
| michael@13 | 63 | |
| michael@13 | 64 | =head1 FILES |
| michael@13 | 65 | |
| michael@13 | 66 | =over 4 |
| michael@13 | 67 | |
| michael@13 | 68 | =item F<@l_prefix@/etc/openpkg/release> |
| michael@13 | 69 | |
| michael@13 | 70 | This optional configuration file can be used to explicitly set values |
| michael@13 | 71 | for the OpenPKG release tag and distribution URLs. It consists of lines |
| michael@13 | 72 | with variable name/value pairs. The following configuration variables |
| michael@13 | 73 | are recognized: |
| michael@13 | 74 | |
| michael@13 | 75 | =over 4 |
| michael@13 | 76 | |
| michael@13 | 77 | =item B<TAG=>I<tag> |
| michael@13 | 78 | |
| michael@13 | 79 | The default I<tag> is automatically derived from the "C<Version>" header |
| michael@13 | 80 | of the OpenPKG bootstrap package B<openpkg>. One usually only sets this |
| michael@13 | 81 | explicitly to a value if a bootstrap package is used from a foreign |
| michael@13 | 82 | distribution version. |
| michael@13 | 83 | |
| michael@13 | 84 | =item B<URL=>I<url> |
| michael@13 | 85 | |
| michael@13 | 86 | The fully-qualified distribution URL based on either the "C<ftp>", |
| michael@13 | 87 | "C<http>" or "C<file>" URL schemes. If I<url> contains a trailing |
| michael@13 | 88 | "C</*>", this is expanded according to the I<tag> value of the B<TAG> |
| michael@428 | 89 | variable and the corresponding filesystem layout on C<download.openpkg.org>. |
| michael@428 | 90 | The default I<url> is "C<http://download.openpkg.org/stacks/*>". |
| michael@13 | 91 | |
| michael@428 | 92 | =back |
| michael@13 | 93 | |
| michael@13 | 94 | =back |
| michael@13 | 95 | |
| michael@13 | 96 | =head1 EXAMPLE |
| michael@13 | 97 | |
| michael@13 | 98 | $ openpkg release |
| michael@428 | 99 | OpenPKG-CURRENT http://download.openpkg.org/stacks/current/ |
| michael@13 | 100 | |
| michael@13 | 101 | $ openpkg release --fmt=%t |
| michael@13 | 102 | CURRENT |
| michael@13 | 103 | |
| michael@13 | 104 | $ openpkg release --fmt=%u |
| michael@428 | 105 | http://download.openpkg.org/stacks/current/ |
| michael@13 | 106 | |
| michael@13 | 107 | $ openpkg release --fmt="OpenPKG %t is located at:\\n%u" |
| michael@13 | 108 | OpenPKG CURRENT is located at: |
| michael@428 | 109 | http://download.openpkg.org/stacks/current/ |
| michael@13 | 110 | |
| michael@13 | 111 | $ openpkg release --release=2.5.4 --fmt=%t |
| michael@13 | 112 | 2.5-RELEASE |
| michael@13 | 113 | |
| michael@13 | 114 | $ cat /openpkg/etc/openpkg/release |
| michael@428 | 115 | TAG=CURRENT |
| michael@428 | 116 | URL=http://download.example.com/stack/current/ |
| michael@13 | 117 | |
| michael@13 | 118 | =head1 SEE ALSO |
| michael@13 | 119 | |
| michael@13 | 120 | uuid(8) |
| michael@13 | 121 | |
| michael@13 | 122 | =head1 HISTORY |
| michael@13 | 123 | |
| michael@13 | 124 | The B<openpkg release> command first appeared in B<OpenPKG 2-STABLE-20060622>. |
| michael@13 | 125 | |
| michael@13 | 126 | =cut |
| michael@13 | 127 |
