comparison: openpkg/release.pod
openpkg/release.pod
- changeset 758
- a2c6460cfb16
- parent 13
- cb59d6afeb61
equal
deleted
inserted
replaced
| 0:fd241ce2cd04 | 1:624e23405092 |
|---|---|
| 1 ## | 1 ## |
| 2 ## release -- OpenPKG Release Utility | 2 ## release -- OpenPKG Release Utility |
| 3 ## Copyright (c) 2000-2007 OpenPKG Foundation e.V. <http://openpkg.net/> | 3 ## Copyright (c) 2000-2012 OpenPKG GmbH <http://openpkg.com/> |
| 4 ## Copyright (c) 2000-2007 Ralf S. Engelschall <http://engelschall.com/> | |
| 5 ## | 4 ## |
| 6 ## Permission to use, copy, modify, and distribute this software for | 5 ## This software is property of the OpenPKG GmbH, DE MUC HRB 160208. |
| 7 ## any purpose with or without fee is hereby granted, provided that | 6 ## All rights reserved. Licenses which grant limited permission to use, |
| 8 ## the above copyright notice and this permission notice appear in all | 7 ## copy, modify and distribute this software are available from the |
| 9 ## copies. | 8 ## OpenPKG GmbH. |
| 10 ## | 9 ## |
| 11 ## THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED | 10 ## THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED |
| 12 ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF | 11 ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
| 13 ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | 12 ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| 14 ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR | 13 ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR |
| 15 ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | 14 ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 16 ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | 15 ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 46 =item B<-F>, B<--fmt> I<format> | 45 =item B<-F>, B<--fmt> I<format> |
| 47 | 46 |
| 48 The output format specification. The argument I<format> is an arbitrary | 47 The output format specification. The argument I<format> is an arbitrary |
| 49 string which can contain the special expansion constructs "C<%t>" for | 48 string which can contain the special expansion constructs "C<%t>" for |
| 50 expanding the release tag, "C<%u>" for expanding the distribution URL | 49 expanding the release tag, "C<%u>" for expanding the distribution URL |
| 51 and "C<\n>" for expanding an embedded newline character. | 50 and "C<\n>" for expanding an embedded newline character. |
| 52 The instance UUID information is also availble by expanding | 51 The instance UUID information is also availble by expanding |
| 53 C<%r> to UUID_REGISTRY, C<%i> to UUID_INSTANCE, C<%p> to UUID_PLATFORM. | 52 C<%r> to UUID_REGISTRY, C<%i> to UUID_INSTANCE, C<%p> to UUID_PLATFORM. |
| 54 The default I<format> is "C<OpenPKG-%t %u>". | 53 The default I<format> is "C<OpenPKG-%t %u>". |
| 55 | 54 |
| 56 =item B<-r>, B<--release> I<release> | 55 =item B<-r>, B<--release> I<release> |
| 85 =item B<URL=>I<url> | 84 =item B<URL=>I<url> |
| 86 | 85 |
| 87 The fully-qualified distribution URL based on either the "C<ftp>", | 86 The fully-qualified distribution URL based on either the "C<ftp>", |
| 88 "C<http>" or "C<file>" URL schemes. If I<url> contains a trailing | 87 "C<http>" or "C<file>" URL schemes. If I<url> contains a trailing |
| 89 "C</*>", this is expanded according to the I<tag> value of the B<TAG> | 88 "C</*>", this is expanded according to the I<tag> value of the B<TAG> |
| 90 variable and the corresponding filesystem layout on C<ftp.openpkg.org>. | 89 variable and the corresponding filesystem layout on C<download.openpkg.org>. |
| 91 The default I<url> is "C<ftp://ftp.openpkg.org/*>". | 90 The default I<url> is "C<http://download.openpkg.org/stacks/*>". |
| 92 | 91 |
| 93 =over | 92 =back |
| 94 | 93 |
| 95 =back | 94 =back |
| 96 | 95 |
| 97 =head1 EXAMPLE | 96 =head1 EXAMPLE |
| 98 | 97 |
| 99 $ openpkg release | 98 $ openpkg release |
| 100 OpenPKG-CURRENT ftp://ftp.openpkg.org/current/SRC/ | 99 OpenPKG-CURRENT http://download.openpkg.org/stacks/current/ |
| 101 | 100 |
| 102 $ openpkg release --fmt=%t | 101 $ openpkg release --fmt=%t |
| 103 CURRENT | 102 CURRENT |
| 104 | 103 |
| 105 $ openpkg release --fmt=%u | 104 $ openpkg release --fmt=%u |
| 106 ftp://ftp.openpkg.org/current/SRC/ | 105 http://download.openpkg.org/stacks/current/ |
| 107 | 106 |
| 108 $ openpkg release --fmt="OpenPKG %t is located at:\\n%u" | 107 $ openpkg release --fmt="OpenPKG %t is located at:\\n%u" |
| 109 OpenPKG CURRENT is located at: | 108 OpenPKG CURRENT is located at: |
| 110 ftp://ftp.openpkg.org/current/SRC/ | 109 http://download.openpkg.org/stacks/current/ |
| 111 | 110 |
| 112 $ openpkg release --release=2.5.4 --fmt=%t | 111 $ openpkg release --release=2.5.4 --fmt=%t |
| 113 2.5-RELEASE | 112 2.5-RELEASE |
| 114 | 113 |
| 115 $ cat /openpkg/etc/openpkg/release | 114 $ cat /openpkg/etc/openpkg/release |
| 116 TAG=2-STABLE-20060622 | 115 TAG=CURRENT |
| 117 URL=ftp://ftp.example.com/mirror/openpkg.org/* | 116 URL=http://download.example.com/stack/current/ |
| 118 | 117 |
| 119 =head1 SEE ALSO | 118 =head1 SEE ALSO |
| 120 | 119 |
| 121 uuid(8) | 120 uuid(8) |
| 122 | 121 |
