comparison: openpkg/rc.pod
openpkg/rc.pod
- changeset 787
- f0da6998c61a
- parent 427
- 71503088f51b
equal
deleted
inserted
replaced
| 1:291d46db67a8 | 2:8b30ad7e92b1 |
|---|---|
| 1 ## | 1 ## |
| 2 ## rc.pod -- RPM Auxiliary Tool (Manual Page) | 2 ## rc.pod -- RPM Auxiliary Tool (Manual Page) |
| 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 |
| 24 | 23 |
| 25 =pod | 24 =pod |
| 26 | 25 |
| 27 =head1 NAME | 26 =head1 NAME |
| 28 | 27 |
| 29 B<@l_prefix@/bin/openpkg rc> - OpenPKG Runcommand Processor | 28 B<@l_prefix@/bin/openpkg rc> - OpenPKG Run-Command Processor |
| 30 | 29 |
| 31 =head1 SYNOPSIS | 30 =head1 SYNOPSIS |
| 32 | 31 |
| 33 B<@l_prefix@/bin/openpkg rc> [B<-s>|B<--silent>] [B<-v>|B<--verbose>] [B<-d>|B<--debug>] [B<-k>|B<--keep>] I<package> I<command> [I<command> ...] | 32 B<@l_prefix@/bin/openpkg rc> [B<-s>|B<--silent>] [B<-v>|B<--verbose>] [B<-d>|B<--debug>] [B<-k>|B<--keep>] [B<-D>|B<--define> I<name>=I<value>] I<package> I<command> [I<command> ...] |
| 34 | 33 |
| 35 B<@l_prefix@/bin/openpkg rc> B<-p>|B<--print> I<package> I<command> [I<command> ...] | 34 B<@l_prefix@/bin/openpkg rc> B<-p>|B<--print> I<package> I<command> [I<command> ...] |
| 36 | 35 |
| 37 eval `B<@l_prefix@/bin/openpkg rc> B<-e>|B<--eval> I<package> I<command> [I<command> ...]` | 36 eval `B<@l_prefix@/bin/openpkg rc> B<-e>|B<--eval> I<package> I<command> [I<command> ...]` |
| 38 | 37 |
| 55 | 54 |
| 56 =head1 USAGE | 55 =head1 USAGE |
| 57 | 56 |
| 58 =over 4 | 57 =over 4 |
| 59 | 58 |
| 60 =item B<@l_prefix@/bin/openpkg rc> [B<-s>|B<--silent>] [B<-v>|B<--verbose>] [B<-d>|B<--debug>] [B<-k>|B<--keep>] I<package> I<command> [I<command> ...] | 59 =item B<@l_prefix@/bin/openpkg rc> [B<-s>|B<--silent>] [B<-v>|B<--verbose>] [B<-d>|B<--debug>] [B<-k>|B<--keep>] [B<-D>|B<--define> I<name>=I<value>] I<package> I<command> [I<command> ...] |
| 61 | 60 |
| 62 B<Runcommand Execution.> This executes one or more specified | 61 B<Run-Command Execution.> This executes one or more specified |
| 63 I<command>s in a particular I<package> or in all installed packages if | 62 I<command>s in a particular I<package> or in all installed packages if |
| 64 I<package> is "C<all>". Option B<--silent> can be used to explicitly | 63 I<package> is "C<all>". Option B<--silent> can be used to explicitly |
| 65 disable progress messages on C<stderr>. Option B<--verbose> can be used | 64 disable progress messages on C<stderr>. Option B<--verbose> can be used |
| 66 to explicitly enable progress messages on C<stderr>. By default, B<rc> | 65 to explicitly enable progress messages on C<stderr>. By default, B<rc> |
| 67 automatically determines whether progress messages should be displayed | 66 automatically determines whether progress messages should be displayed |
| 68 or not depending on whether C<stderr> is connected to a terminal device. | 67 or not depending on whether C<stderr> is connected to a terminal device. |
| 69 Option B<--keep> can be used for debugging purposes to keep the | 68 Option B<--keep> can be used for debugging purposes to keep the |
| 70 temporary files were generated during internal processing. | 69 temporary files were generated during internal processing. Option |
| 70 B<--define> can be used to on-the-fly re-define a configuration variable | |
| 71 I<name> with I<value>. | |
| 71 | 72 |
| 72 =item B<@l_prefix@/bin/openpkg rc> B<-p>|B<--print> I<package> I<command> [I<command> ...] | 73 =item B<@l_prefix@/bin/openpkg rc> B<-p>|B<--print> I<package> I<command> [I<command> ...] |
| 73 | 74 |
| 74 B<Runcommand Printing.> This is like the run-command execution (see | 75 B<Run-Command Printing.> This is like the run-command execution (see |
| 75 above), but instead of immediately executing all involved individual | 76 above), but instead of immediately executing all involved individual |
| 76 run-command scripts, they are concatenated (but with all configuration | 77 run-command scripts, they are concatenated (but with all configuration |
| 77 parts reduced to a single configuration part) and printed to C<stdout>. | 78 parts reduced to a single configuration part) and printed to C<stdout>. |
| 78 Use this for debugging or post-processing purposes. | 79 Use this for debugging or post-processing purposes. |
| 79 | 80 |
| 80 =item eval `B<@l_prefix@/bin/openpkg rc> B<-e>|B<--eval> I<package> I<command> [I<command> ...]` | 81 =item eval `B<@l_prefix@/bin/openpkg rc> B<-e>|B<--eval> I<package> I<command> [I<command> ...]` |
| 81 | 82 |
| 82 B<Runcommand Evaluation.> This is like the run-command execution | 83 B<Run-Command Evaluation.> This is like the run-command execution |
| 83 (see above), but the resulting exported shell environment variables | 84 (see above), but the resulting exported shell environment variables |
| 84 are output to a temporary file as a (Bourne-Shell or C-Shell syntax) | 85 are output to a temporary file as a (Bourne-Shell or C-Shell syntax) |
| 85 shell script, suitable for evaluation within the shell environment | 86 shell script, suitable for evaluation within the shell environment |
| 86 of the caller. A one-line script is printed to C<stdout> which then | 87 of the caller. A one-line script is printed to C<stdout> which then |
| 87 "sources" (and immediately removes) this temporary file. This is | 88 "sources" (and immediately removes) this temporary file. This is |
