You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

462 lines
16 KiB

  1. <!-- -*- mode: xml; mode: fold -*- -->
  2. <!-- Some common paths.. -->
  3. <!ENTITY docdir "/usr/share/doc/apt/">
  4. <!ENTITY guidesdir "/usr/share/doc/apt-doc/">
  5. <!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>">
  6. <!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>">
  7. <!ENTITY statedir "/var/lib/apt">
  8. <!ENTITY cachedir "/var/cache/apt">
  9. <!-- Cross references to other man pages -->
  10. <!ENTITY apt-conf "<citerefentry>
  11. <refentrytitle><filename>apt.conf</filename></refentrytitle>
  12. <manvolnum>5</manvolnum>
  13. </citerefentry>"
  14. >
  15. <!ENTITY apt-get "<citerefentry>
  16. <refentrytitle><command>apt-get</command></refentrytitle>
  17. <manvolnum>8</manvolnum>
  18. </citerefentry>"
  19. >
  20. <!ENTITY apt-config "<citerefentry>
  21. <refentrytitle><command>apt-config</command></refentrytitle>
  22. <manvolnum>8</manvolnum>
  23. </citerefentry>"
  24. >
  25. <!ENTITY apt-cdrom "<citerefentry>
  26. <refentrytitle><command>apt-cdrom</command></refentrytitle>
  27. <manvolnum>8</manvolnum>
  28. </citerefentry>"
  29. >
  30. <!ENTITY apt-cache "<citerefentry>
  31. <refentrytitle><command>apt-cache</command></refentrytitle>
  32. <manvolnum>8</manvolnum>
  33. </citerefentry>"
  34. >
  35. <!ENTITY apt-mark "<citerefentry>
  36. <refentrytitle><command>apt-mark</command></refentrytitle>
  37. <manvolnum>8</manvolnum>
  38. </citerefentry>"
  39. >
  40. <!ENTITY apt "<citerefentry>
  41. <refentrytitle><command>apt</command></refentrytitle>
  42. <manvolnum>8</manvolnum>
  43. </citerefentry>"
  44. >
  45. <!ENTITY apt-preferences "<citerefentry>
  46. <refentrytitle><filename>apt_preferences</filename></refentrytitle>
  47. <manvolnum>5</manvolnum>
  48. </citerefentry>"
  49. >
  50. <!ENTITY apt-key "<citerefentry>
  51. <refentrytitle><command>apt-key</command></refentrytitle>
  52. <manvolnum>8</manvolnum>
  53. </citerefentry>"
  54. >
  55. <!ENTITY apt-secure "<citerefentry>
  56. <refentrytitle>apt-secure</refentrytitle>
  57. <manvolnum>8</manvolnum>
  58. </citerefentry>"
  59. >
  60. <!ENTITY apt-ftparchive "<citerefentry>
  61. <refentrytitle><command>apt-ftparchive</command></refentrytitle>
  62. <manvolnum>1</manvolnum>
  63. </citerefentry>"
  64. >
  65. <!ENTITY sources-list "<citerefentry>
  66. <refentrytitle><filename>sources.list</filename></refentrytitle>
  67. <manvolnum>5</manvolnum>
  68. </citerefentry>"
  69. >
  70. <!ENTITY reportbug "<citerefentry>
  71. <refentrytitle><command>reportbug</command></refentrytitle>
  72. <manvolnum>1</manvolnum>
  73. </citerefentry>"
  74. >
  75. <!ENTITY dpkg "<citerefentry>
  76. <refentrytitle><command>dpkg</command></refentrytitle>
  77. <manvolnum>1</manvolnum>
  78. </citerefentry>"
  79. >
  80. <!ENTITY dpkg-buildpackage "<citerefentry>
  81. <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
  82. <manvolnum>1</manvolnum>
  83. </citerefentry>"
  84. >
  85. <!ENTITY gzip "<citerefentry>
  86. <refentrytitle><command>gzip</command></refentrytitle>
  87. <manvolnum>1</manvolnum>
  88. </citerefentry>"
  89. >
  90. <!ENTITY dpkg-scanpackages "<citerefentry>
  91. <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
  92. <manvolnum>1</manvolnum>
  93. </citerefentry>"
  94. >
  95. <!ENTITY dpkg-scansources "<citerefentry>
  96. <refentrytitle><command>dpkg-scansources</command></refentrytitle>
  97. <manvolnum>1</manvolnum>
  98. </citerefentry>"
  99. >
  100. <!ENTITY dselect "<citerefentry>
  101. <refentrytitle><command>dselect</command></refentrytitle>
  102. <manvolnum>1</manvolnum>
  103. </citerefentry>"
  104. >
  105. <!ENTITY aptitude "<citerefentry>
  106. <refentrytitle><command>aptitude</command></refentrytitle>
  107. <manvolnum>8</manvolnum>
  108. </citerefentry>"
  109. >
  110. <!ENTITY synaptic "<citerefentry>
  111. <refentrytitle><command>synaptic</command></refentrytitle>
  112. <manvolnum>8</manvolnum>
  113. </citerefentry>"
  114. >
  115. <!ENTITY squid-deb-proxy-client "<citerefentry>
  116. <refentrytitle><command>squid-deb-proxy-client</command></refentrytitle>
  117. <manvolnum>1</manvolnum>
  118. </citerefentry>"
  119. >
  120. <!ENTITY debsign "<citerefentry>
  121. <refentrytitle><command>debsign</command></refentrytitle>
  122. <manvolnum>1</manvolnum>
  123. </citerefentry>"
  124. >
  125. <!ENTITY debsig-verify "<citerefentry>
  126. <refentrytitle><command>debsig-verify</command></refentrytitle>
  127. <manvolnum>1</manvolnum>
  128. </citerefentry>"
  129. >
  130. <!ENTITY gpg "<citerefentry>
  131. <refentrytitle><command>gpg</command></refentrytitle>
  132. <manvolnum>1</manvolnum>
  133. </citerefentry>"
  134. >
  135. <!ENTITY wajig "<citerefentry>
  136. <refentrytitle><command>wajig</command></refentrytitle>
  137. <manvolnum>1</manvolnum>
  138. </citerefentry>"
  139. >
  140. <!ENTITY wget "<citerefentry>
  141. <refentrytitle><command>wget</command></refentrytitle>
  142. <manvolnum>1</manvolnum>
  143. </citerefentry>"
  144. >
  145. <!ENTITY apt-transport-debtorrent "<citerefentry>
  146. <refentrytitle><package>apt-transport-debtorrent</package></refentrytitle>
  147. <manvolnum>1</manvolnum>
  148. </citerefentry>"
  149. >
  150. <!ENTITY regex "<citerefentry>
  151. <refentrytitle><abbrev>regex</abbrev></refentrytitle>
  152. <manvolnum>7</manvolnum>
  153. </citerefentry>"
  154. >
  155. <!ENTITY glob "<citerefentry>
  156. <refentrytitle><abbrev>glob</abbrev></refentrytitle>
  157. <manvolnum>7</manvolnum>
  158. </citerefentry>"
  159. >
  160. <!ENTITY apt-file "<citerefentry>
  161. <refentrytitle><command>apt-file</command></refentrytitle>
  162. <manvolnum>1</manvolnum>
  163. </citerefentry>"
  164. >
  165. <!ENTITY apt-acquire-additional-files "<literal><filename>/usr/share/doc/apt-doc/acquire-additional-files.txt</filename></literal>">
  166. <!-- Boiler plate docinfo section -->
  167. <!ENTITY apt-email "
  168. <address>
  169. <email>apt@packages.debian.org</email>
  170. </address>
  171. ">
  172. <!ENTITY apt-author.jgunthorpe "
  173. <author>
  174. <firstname>Jason</firstname>
  175. <surname>Gunthorpe</surname>
  176. <contrib></contrib>
  177. </author>
  178. ">
  179. <!ENTITY apt-author.moconnor "
  180. <author>
  181. <firstname>Mike</firstname>
  182. <surname>O'Connor</surname>
  183. <contrib></contrib>
  184. </author>
  185. ">
  186. <!ENTITY apt-name.dburrows "
  187. <firstname>Daniel</firstname>
  188. <surname>Burrows</surname>
  189. ">
  190. <!ENTITY apt-copyright "
  191. <copyright>
  192. <holder>Jason Gunthorpe</holder>
  193. <year>1998-2001</year>
  194. </copyright>
  195. ">
  196. <!ENTITY apt-product "
  197. <productname>APT</productname>
  198. <releaseinfo role='version'>&apt-product-version;</releaseinfo>
  199. ">
  200. <!-- this will be updated by 'prepare-release' -->
  201. <!ENTITY apt-product-version "1.4.4">
  202. <!-- (Code)names for various things used all over the place -->
  203. <!ENTITY debian-oldstable-codename "jessie">
  204. <!ENTITY debian-stable-codename "stretch">
  205. <!ENTITY debian-testing-codename "buster">
  206. <!ENTITY debian-stable-version "9">
  207. <!ENTITY ubuntu-codename "xenial">
  208. <!-- good and bad just refers to matching and not matching a pattern…
  209. It is not a remark about the specific perl version.
  210. There is no way perl could be classified "good" (or "bad") in any version… -->
  211. <!ENTITY good-perl "5.20">
  212. <!ENTITY bad-perl "5.24">
  213. <!-- Arguments -->
  214. <!ENTITY synopsis-arg-option "<arg><option>-o=<replaceable>&synopsis-config-string;</replaceable></option></arg>">
  215. <!ENTITY synopsis-arg-config "<arg><option>-c=<filename><replaceable>&synopsis-config-file;</replaceable></filename></option></arg>">
  216. <!ENTITY synopsis-arg-target-release "<arg><option>-t=<replaceable>&synopsis-target-release;</replaceable></option></arg>">
  217. <!ENTITY synopsis-arg-architecture "<arg><option>-a=<replaceable>&synopsis-architecture;</replaceable></option></arg>">
  218. <!ENTITY synopsis-arg-pkgver "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable><arg><group choice='req'>
  219. <arg choice='plain'>=<replaceable>&synopsis-pkg-ver-number;</replaceable></arg>
  220. <arg choice='plain'>/<replaceable>&synopsis-target-release;</replaceable></arg>
  221. </group></arg></arg>">
  222. <!ENTITY synopsis-arg-pkg "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>">
  223. <!ENTITY synopsis-param-filename "<filename><replaceable>&synopsis-filename;</replaceable></filename>">
  224. <!ENTITY synopsis-help "<arg choice='plain'><group choice='req'><arg choice='plain'>-v</arg><arg choice='plain'>--version</arg></group></arg>
  225. <arg choice='plain'><group choice='req'><arg choice='plain'>-h</arg><arg choice='plain'>--help</arg></group></arg>">
  226. <!ENTITY synopsis-command-apt "<refsynopsisdiv><cmdsynopsis>
  227. <command>apt</command>
  228. <arg><option>-h</option></arg>
  229. &synopsis-arg-option;
  230. &synopsis-arg-config;
  231. &synopsis-arg-target-release;
  232. &synopsis-arg-architecture;
  233. <group choice='req'>
  234. <arg choice='plain'>list</arg>
  235. <arg choice='plain'>search</arg>
  236. <arg choice='plain'>show</arg>
  237. <arg choice='plain'>update</arg>
  238. <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
  239. <arg choice='plain'>remove &synopsis-arg-pkg;</arg>
  240. <arg choice='plain'>upgrade</arg>
  241. <arg choice='plain'>full-upgrade</arg>
  242. <arg choice='plain'>edit-sources</arg>
  243. &synopsis-help;
  244. </group>
  245. </cmdsynopsis></refsynopsisdiv>">
  246. <!ENTITY synopsis-command-apt-get "<refsynopsisdiv><cmdsynopsis>
  247. <command>apt-get</command>
  248. <arg><option>-asqdyfmubV</option></arg>
  249. &synopsis-arg-option;
  250. &synopsis-arg-config;
  251. &synopsis-arg-target-release;
  252. &synopsis-arg-architecture;
  253. <group choice='req'>
  254. <arg choice='plain'>update</arg>
  255. <arg choice='plain'>upgrade</arg>
  256. <arg choice='plain'>dselect-upgrade</arg>
  257. <arg choice='plain'>dist-upgrade</arg>
  258. <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
  259. <arg choice='plain'>remove &synopsis-arg-pkg;</arg>
  260. <arg choice='plain'>purge &synopsis-arg-pkg;</arg>
  261. <arg choice='plain'>source &synopsis-arg-pkgver;</arg>
  262. <arg choice='plain'>build-dep &synopsis-arg-pkgver;</arg>
  263. <arg choice='plain'>download &synopsis-arg-pkgver;</arg>
  264. <arg choice='plain'>check</arg>
  265. <arg choice='plain'>clean</arg>
  266. <arg choice='plain'>autoclean</arg>
  267. <arg choice='plain'>autoremove</arg>
  268. &synopsis-help;
  269. </group>
  270. </cmdsynopsis></refsynopsisdiv>">
  271. <!ENTITY synopsis-command-apt-cache "<refsynopsisdiv><cmdsynopsis>
  272. <command>apt-cache</command>
  273. <arg><option>-agipns</option></arg>
  274. &synopsis-arg-option;
  275. &synopsis-arg-config;
  276. <group choice='req'>
  277. <arg choice='plain'>gencaches</arg>
  278. <arg choice='plain'>showpkg &synopsis-arg-pkg;</arg>
  279. <arg choice='plain'>showsrc &synopsis-arg-pkg;</arg>
  280. <arg choice='plain'>stats</arg>
  281. <arg choice='plain'>dump</arg>
  282. <arg choice='plain'>dumpavail</arg>
  283. <arg choice='plain'>unmet</arg>
  284. <arg choice='plain'>search <arg choice='plain' rep='repeat'><replaceable>&synopsis-regex;</replaceable></arg></arg>
  285. <arg choice='plain'>show &synopsis-arg-pkgver;</arg>
  286. <arg choice='plain'>depends &synopsis-arg-pkgver;</arg>
  287. <arg choice='plain'>rdepends &synopsis-arg-pkgver;</arg>
  288. <arg choice='plain'>pkgnames <arg><replaceable>&synopsis-prefix;</replaceable></arg></arg>
  289. <arg choice='plain'>dotty &synopsis-arg-pkgver;</arg>
  290. <arg choice='plain'>xvcg &synopsis-arg-pkgver;</arg>
  291. <arg choice='plain'>policy <arg rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg></arg>
  292. <arg choice='plain'>madison &synopsis-arg-pkg;</arg>
  293. &synopsis-help;
  294. </group>
  295. </cmdsynopsis></refsynopsisdiv>">
  296. <!ENTITY synopsis-command-apt-cdrom "<refsynopsisdiv><cmdsynopsis>
  297. <command>apt-cdrom</command>
  298. <arg><option>-rmfan</option></arg>
  299. <arg><option>-d=<replaceable>&synopsis-cdrom-mount;</replaceable></option></arg>
  300. &synopsis-arg-option;
  301. &synopsis-arg-config;
  302. <group choice='req'>
  303. <arg choice='plain'>add</arg>
  304. <arg choice='plain'>ident</arg>
  305. &synopsis-help;
  306. </group>
  307. </cmdsynopsis></refsynopsisdiv>">
  308. <!--<arg><option>- -format '<replaceable>&#37;f \"&#37;v\";&#37;n</replaceable>'</option></arg>-->
  309. <!ENTITY synopsis-command-apt-config "<refsynopsisdiv><cmdsynopsis>
  310. <command>apt-config</command>
  311. <arg><option>--empty</option></arg>
  312. <arg><option>--format '<replaceable>&percnt;f &#x0022;&percnt;v&#x0022;;&percnt;n</replaceable>'</option></arg>
  313. &synopsis-arg-option;
  314. &synopsis-arg-config;
  315. <group choice='req'>
  316. <arg choice='plain'>shell</arg>
  317. <arg choice='plain'>dump</arg>
  318. &synopsis-help;
  319. </group>
  320. </cmdsynopsis></refsynopsisdiv>">
  321. <!ENTITY synopsis-command-apt-extracttemplates "<refsynopsisdiv><cmdsynopsis>
  322. <command>apt-extracttemplates</command>
  323. <arg><option>-t=<replaceable>&synopsis-tmp-directory;</replaceable></option></arg>
  324. <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg>
  325. &synopsis-help;
  326. </cmdsynopsis></refsynopsisdiv>">
  327. <!ENTITY synopsis-arg-ftparchive "<arg choice='plain' rep='repeat'><replaceable>&synopsis-path;</replaceable></arg><arg><filename><replaceable>&synopsis-override;</replaceable></filename><arg><replaceable>&synopsis-pathprefix;</replaceable></arg></arg>">
  328. <!ENTITY synopsis-command-apt-ftparchive "<refsynopsisdiv><cmdsynopsis>
  329. <command>apt-ftparchive</command>
  330. <arg><option>-dsq</option></arg>
  331. <arg><option>--md5</option></arg>
  332. <arg><option>--delink</option></arg>
  333. <arg><option>--readonly</option></arg>
  334. <arg><option>--contents</option></arg>
  335. <arg><option>--arch <replaceable>architecture</replaceable></option></arg>
  336. &synopsis-arg-option;
  337. &synopsis-arg-config;
  338. <group choice='req'>
  339. <arg choice='plain'>packages &synopsis-arg-ftparchive;</arg>
  340. <arg choice='plain'>sources &synopsis-arg-ftparchive;</arg>
  341. <arg choice='plain'>contents <arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg></arg>
  342. <arg choice='plain'>release <arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg></arg>
  343. <arg choice='plain'>generate <arg choice='plain'><replaceable>&synopsis-config-file;</replaceable></arg> <arg choice='plain' rep='repeat'><replaceable>&synopsis-section;</replaceable></arg></arg>
  344. <arg choice='plain'>clean <arg choice='plain'><replaceable>&synopsis-config-file;</replaceable></arg></arg>
  345. &synopsis-help;
  346. </group>
  347. </cmdsynopsis></refsynopsisdiv>">
  348. <!ENTITY synopsis-param-keyid "<replaceable>&synopsis-keyid;</replaceable>">
  349. <!ENTITY synopsis-command-apt-key "<refsynopsisdiv><cmdsynopsis>
  350. <command>apt-key</command>
  351. <arg><option>--keyring &synopsis-param-filename;</option></arg>
  352. <group choice='req'>
  353. <arg choice='plain'>add &synopsis-param-filename;</arg>
  354. <arg choice='plain'>del &synopsis-param-keyid;</arg>
  355. <arg choice='plain'>export &synopsis-param-keyid;</arg>
  356. <arg choice='plain'>exportall</arg>
  357. <arg choice='plain'>list</arg>
  358. <arg choice='plain'>finger</arg>
  359. <arg choice='plain'>adv</arg>
  360. <arg choice='plain'>update</arg>
  361. <arg choice='plain'>net-update</arg>
  362. &synopsis-help;
  363. </group>
  364. </cmdsynopsis></refsynopsisdiv>">
  365. <!ENTITY synopsis-command-apt-mark "<refsynopsisdiv><cmdsynopsis>
  366. <command>apt-mark</command>
  367. <group choice='plain'>
  368. <group choice='req'>
  369. <arg choice='plain'><option>-f=&synopsis-param-filename;</option></arg>
  370. <arg choice='plain'>
  371. <group choice='req'>
  372. <arg choice='plain'>auto</arg>
  373. <arg choice='plain'>manual</arg>
  374. </group>
  375. &synopsis-arg-pkg;
  376. </arg>
  377. <arg choice='plain'>
  378. <group choice='req'>
  379. <arg choice='plain'>showauto</arg>
  380. <arg choice='plain'>showmanual</arg>
  381. </group>
  382. <arg choice='opt' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>
  383. </arg>
  384. </group>
  385. &synopsis-help;
  386. </group>
  387. </cmdsynopsis><cmdsynopsis><command>apt-mark</command>
  388. <group choice='plain'>
  389. <arg choice='plain'>
  390. <group choice='req'>
  391. <arg choice='plain'>hold</arg>
  392. <arg choice='plain'>unhold</arg>
  393. <arg choice='plain'>install</arg>
  394. <arg choice='plain'>remove</arg>
  395. <arg choice='plain'>purge</arg>
  396. </group>
  397. &synopsis-arg-pkg;
  398. </arg>
  399. <arg choice='plain'>
  400. <group choice='req'>
  401. <arg choice='plain'>showhold</arg>
  402. <arg choice='plain'>showinstall</arg>
  403. <arg choice='plain'>showremove</arg>
  404. <arg choice='plain'>showpurge</arg>
  405. </group>
  406. <arg choice='opt' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>
  407. </arg>
  408. </group>
  409. </cmdsynopsis></refsynopsisdiv>">
  410. <!ENTITY synopsis-command-apt-sortpkgs "<refsynopsisdiv><cmdsynopsis>
  411. <command>apt-sortpkgs</command>
  412. <arg><option>-s</option></arg>
  413. &synopsis-arg-option;
  414. &synopsis-arg-config;
  415. <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg>
  416. &synopsis-help;
  417. </cmdsynopsis></refsynopsisdiv>">