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.
 
 
 
 
 
 

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