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.
 
 
 
 
 
 

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