projects / 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 | |
| 17 | ) | |
| 18 | ||
| 19 | Unless the -h, or --help option is given one of the above commands | |
| 20 | must be present. | |
| 21 | ||
| 22 | startdit() | |
| 23 | dit(bf(shell)) | |
| 24 | bf(shell) is used to access the configuration information from a shell script. | |
| 25 | It is given pairs of arguments, the first being a shell variable and the | |
| 26 | second the configuration value to query. As output it lists a series of shell | |
| 27 | assignments commands for each present value. In a shell script it should be | |
| 28 | used like: | |
| 29 | ||
| 30 | verb( | |
| 31 | OPTS="-f" | |
| 32 | ||
| 33 | RES=`apt-config shell OPTS MyApp::Options` | |
| 34 | ||
| 35 | eval $RES | |
| 36 | ) | |
| 37 | ||
| 38 | This will set the shell environment variable $OPTS to the value of | |
| 39 | MyApp::Options with a default of -f. | |
| 40 | ||
| e42eb508 AL |
41 | If the configuration item to retrieve is prefixed with a / then it will |
| 42 | be retrieved using filename mode which prepends base paths. | |
| 43 | ||
| c5796672 AL |
44 | enddit() |
| 45 | ||
| 46 | manpageoptions() | |
| 47 | All command line options may be set using the configuration file, the | |
| 48 | descriptions indicate the configuration option to set. For boolean | |
| 49 | options you can override the config file by using something like bf(-f-), | |
| 50 | bf(--no-f), bf(-f=no) or several other variations. | |
| 51 | ||
| 52 | startdit() | |
| 53 | dit(bf(-h, --help)) | |
| 54 | Show a short usage summary. | |
| 55 | ||
| 56 | dit(bf(-v, --version)) | |
| 57 | Show the program verison. | |
| 58 | ||
| 59 | dit(bf(-c, --config-file)) | |
| 60 | Configuration File; Specify a configuration file to use. bf(apt-get) will | |
| 61 | read the default configuration file and then this configuration file. See | |
| 62 | bf(apt.conf(5)) for syntax information. | |
| 63 | ||
| 64 | dit(bf(-o, --option)) | |
| 65 | Set a Configuration Option; This will set an arbitary configuration option. | |
| 66 | The syntax is | |
| 67 | verb(-o Foo::Bar=bar) | |
| 68 | enddit() | |
| 69 | ||
| 70 | manpageseealso() | |
| 71 | apt.conf(5) | |
| 72 | ||
| 73 | manpagediagnostics() | |
| 74 | apt-config returns zero on normal operation, decimal 100 on error. | |
| 75 | ||
| 76 | manpagebugs() | |
| 77 | See http://bugs.debian.org/apt. If you wish to report a | |
| 78 | bug in bf(apt-config), please see bf(/usr/doc/debian/bug-reporting.txt) | |
| 79 | or the bf(bug(1)) command. | |
| 80 | ||
| 81 | manpageauthor() | |
| 82 | apt-get was written by the APT team <apt@packages.debian.org>. |