HCoop / ntk / apt.git / blame
| Commit | Line | Data |
|---|---|---|
| c5796672 AL |
1 | mailto(apt@packages.debian.org) |
| 2 | manpage(apt-config)(8)(14 Feb 1999)(apt)() | |
| 3 | manpagename(apt-config)(APT Configuration Query program) | |
| 4 | ||
| 5 | manpagesynopsis() | |
| 6 | apt-config command | |
| 7 | ||
| 8 | manpagedescription() | |
| 9 | bf(apt-config) is an internal program used by various portions of the APT | |
| dedbcda0 | 10 | suite to provide consistent configurability. It accesses the main configuarion |
| c5796672 AL |
11 | file /etc/apt/apt.conf in a manner that is easy to use by scripted |
| 12 | applications. | |
| 13 | ||
| 14 | em(command) is one of: | |
| 15 | itemize( | |
| 16 | it() shell | |
| 314037ba | 17 | it() dump |
| c5796672 AL |
18 | ) |
| 19 | ||
| 20 | Unless the -h, or --help option is given one of the above commands | |
| 21 | must be present. | |
| 22 | ||
| 23 | startdit() | |
| 24 | dit(bf(shell)) | |
| 25 | bf(shell) is used to access the configuration information from a shell script. | |
| 26 | It is given pairs of arguments, the first being a shell variable and the | |
| 27 | second the configuration value to query. As output it lists a series of shell | |
| 28 | assignments commands for each present value. In a shell script it should be | |
| 29 | used like: | |
| 30 | ||
| 31 | verb( | |
| 32 | OPTS="-f" | |
| 33 | ||
| 34 | RES=`apt-config shell OPTS MyApp::Options` | |
| 35 | ||
| 36 | eval $RES | |
| 37 | ) | |
| 38 | ||
| 39 | This will set the shell environment variable $OPTS to the value of | |
| 40 | MyApp::Options with a default of -f. | |
| 41 | ||
| e42eb508 AL |
42 | If the configuration item to retrieve is prefixed with a / then it will |
| 43 | be retrieved using filename mode which prepends base paths. | |
| 44 | ||
| 314037ba AL |
45 | dit(bf(dump)) |
| 46 | Just show the contents of the configuration space. | |
| 47 | ||
| c5796672 AL |
48 | enddit() |
| 49 | ||
| 50 | manpageoptions() | |
| 51 | All command line options may be set using the configuration file, the | |
| 52 | descriptions indicate the configuration option to set. For boolean | |
| 53 | options you can override the config file by using something like bf(-f-), | |
| 54 | bf(--no-f), bf(-f=no) or several other variations. | |
| 55 | ||
| 56 | startdit() | |
| 57 | dit(bf(-h, --help)) | |
| 58 | Show a short usage summary. | |
| 59 | ||
| 60 | dit(bf(-v, --version)) | |
| 61 | Show the program verison. | |
| 62 | ||
| 63 | dit(bf(-c, --config-file)) | |
| 64 | Configuration File; Specify a configuration file to use. bf(apt-get) will | |
| 65 | read the default configuration file and then this configuration file. See | |
| 66 | bf(apt.conf(5)) for syntax information. | |
| 67 | ||
| 68 | dit(bf(-o, --option)) | |
| 69 | Set a Configuration Option; This will set an arbitary configuration option. | |
| 70 | The syntax is | |
| 71 | verb(-o Foo::Bar=bar) | |
| 72 | enddit() | |
| 73 | ||
| 74 | manpageseealso() | |
| 75 | apt.conf(5) | |
| 76 | ||
| 77 | manpagediagnostics() | |
| 78 | apt-config returns zero on normal operation, decimal 100 on error. | |
| 79 | ||
| 80 | manpagebugs() | |
| 81 | See http://bugs.debian.org/apt. If you wish to report a | |
| 82 | bug in bf(apt-config), please see bf(/usr/doc/debian/bug-reporting.txt) | |
| 83 | or the bf(bug(1)) command. | |
| 84 | ||
| 85 | manpageauthor() | |
| 86 | apt-get was written by the APT team <apt@packages.debian.org>. |