{ "content": [ { "type": "text", "text": "# APT-MARK (man)\n\n## NAME\n\napt-mark - show, set and unset various settings for a package\n\n## SYNOPSIS\n\napt-mark {-f=filename | {auto | manual} pkg... | {showauto | showmanual} [pkg...] } |\n{-v | --version} | {-h | --help}\napt-mark {hold | unhold | install | remove | purge} pkg... |\n{showhold | showinstall | showremove | showpurge} [pkg...]\n\n## DESCRIPTION\n\napt-mark can be used as a unified front-end to set various settings for a package, such as\nmarking a package as being automatically/manually installed or changing dpkg selections such\nas hold, install, deinstall and purge which are respected e.g. by apt-get dselect-upgrade or\naptitude.\n\n## TLDR\n\n> Utility to change the status of installed packages.\n\n- Mark a package as automatically installed:\n `sudo apt-mark auto {{package}}`\n- Hold a package at its current version and prevent updates to it:\n `sudo apt-mark hold {{package}}`\n- Allow a package to be updated again:\n `sudo apt-mark unhold {{package}}`\n- Show manually installed packages:\n `apt-mark showmanual`\n- Show held packages that aren't being updated:\n `apt-mark showhold`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **AUTOMATICALLY AND MANUALLY INSTALLED PACKAGES** (7 subsections)\n- **PREVENT CHANGES FOR A PACKAGE** (4 subsections)\n- **OPTIONS** (4 subsections)\n- **FILES**\n- **SEE ALSO**\n- **DIAGNOSTICS**\n- **BUGS**\n- **AUTHORS** (2 subsections)\n- **NOTES**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "APT-MARK", "section": "", "mode": "man", "summary": "apt-mark - show, set and unset various settings for a package", "synopsis": "apt-mark {-f=filename | {auto | manual} pkg... | {showauto | showmanual} [pkg...] } |\n{-v | --version} | {-h | --help}\napt-mark {hold | unhold | install | remove | purge} pkg... |\n{showhold | showinstall | showremove | showpurge} [pkg...]", "tldr_summary": "Utility to change the status of installed packages.", "tldr_examples": [ { "description": "Mark a package as automatically installed", "command": "sudo apt-mark auto {{package}}" }, { "description": "Hold a package at its current version and prevent updates to it", "command": "sudo apt-mark hold {{package}}" }, { "description": "Allow a package to be updated again", "command": "sudo apt-mark unhold {{package}}" }, { "description": "Show manually installed packages", "command": "apt-mark showmanual" }, { "description": "Show held packages that aren't being updated", "command": "apt-mark showhold" } ], "tldr_source": "official", "flags": [ { "flag": "-h", "long": "--help", "arg": null, "description": "Show a short usage summary." }, { "flag": "-v", "long": "--version", "arg": null, "description": "Show the program version." }, { "flag": "-c", "long": "--config-file", "arg": null, "description": "Configuration File; Specify a configuration file to use. The program will read the default configuration file and then this configuration file. If configuration settings need to be set before the default configuration files are parsed specify a file with the APTCONFIG environment variable. See apt.conf(5) for syntax information." }, { "flag": "-o", "long": "--option", "arg": null, "description": "Set a Configuration Option; This will set an arbitrary configuration option. The syntax is -o Foo::Bar=bar. -o and --option can be used multiple times to set different options." } ], "examples": [], "see_also": [ { "name": "apt-get", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/apt-get/8/json" }, { "name": "aptitude", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/aptitude/8/json" }, { "name": "apt.conf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/apt.conf/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 6, "subsections": [] }, { "name": "DESCRIPTION", "lines": 5, "subsections": [] }, { "name": "AUTOMATICALLY AND MANUALLY INSTALLED PACKAGES", "lines": 6, "subsections": [ { "name": "auto", "lines": 3 }, { "name": "manual", "lines": 3 }, { "name": "minimize-manual", "lines": 5 }, { "name": "showauto", "lines": 4 }, { "name": "showmanual", "lines": 3 }, { "name": "Options", "lines": 1 }, { "name": "-f= --file=", "lines": 4 } ] }, { "name": "PREVENT CHANGES FOR A PACKAGE", "lines": 1, "subsections": [ { "name": "hold", "lines": 3 }, { "name": "unhold", "lines": 2 }, { "name": "showhold", "lines": 3 }, { "name": "SCHEDULE PACKAGES FOR INSTALL, REMOVE AND PURGE", "lines": 6 } ] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-h --help", "lines": 2, "flag": "-h", "long": "--help" }, { "name": "-v --version", "lines": 2, "flag": "-v", "long": "--version" }, { "name": "-c --config-file", "lines": 5, "flag": "-c", "long": "--config-file" }, { "name": "-o --option", "lines": 3, "flag": "-o", "long": "--option" } ] }, { "name": "FILES", "lines": 3, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "DIAGNOSTICS", "lines": 2, "subsections": [] }, { "name": "BUGS", "lines": 3, "subsections": [] }, { "name": "AUTHORS", "lines": 1, "subsections": [ { "name": "Mike O'Connor", "lines": 1 }, { "name": "APT team", "lines": 1 } ] }, { "name": "NOTES", "lines": 6, "subsections": [] } ], "sections": { "NAME": { "content": "apt-mark - show, set and unset various settings for a package\n", "subsections": [] }, "SYNOPSIS": { "content": "apt-mark {-f=filename | {auto | manual} pkg... | {showauto | showmanual} [pkg...] } |\n{-v | --version} | {-h | --help}\n\napt-mark {hold | unhold | install | remove | purge} pkg... |\n{showhold | showinstall | showremove | showpurge} [pkg...]\n", "subsections": [] }, "DESCRIPTION": { "content": "apt-mark can be used as a unified front-end to set various settings for a package, such as\nmarking a package as being automatically/manually installed or changing dpkg selections such\nas hold, install, deinstall and purge which are respected e.g. by apt-get dselect-upgrade or\naptitude.\n", "subsections": [] }, "AUTOMATICALLY AND MANUALLY INSTALLED PACKAGES": { "content": "When you request that a package is installed, and as a result other packages are installed to\nsatisfy its dependencies, the dependencies are marked as being automatically installed, while\nthe package you installed explicitly is marked as manually installed. Once an automatically\ninstalled package is no longer depended on by any manually installed package it is considered\nno longer needed and e.g. apt-get or aptitude will at least suggest removing them.\n", "subsections": [ { "name": "auto", "content": "auto is used to mark a package as being automatically installed, which will cause the\npackage to be removed when no more manually installed packages depend on this package.\n" }, { "name": "manual", "content": "manual is used to mark a package as being manually installed, which will prevent the\npackage from being automatically removed if no other packages depend on it.\n" }, { "name": "minimize-manual", "content": "minimize-manual is used to mark (transitive) dependencies of metapackages as\nautomatically installed. This can be used after an installation for example, to minimize\nthe number of manually installed packages; or continuously on systems managed by system\nconfiguration metapackages.\n" }, { "name": "showauto", "content": "showauto is used to print a list of automatically installed packages with each package on\na new line. All automatically installed packages will be listed if no package is given.\nIf packages are given only those which are automatically installed will be shown.\n" }, { "name": "showmanual", "content": "showmanual can be used in the same way as showauto except that it will print a list of\nmanually installed packages instead.\n" }, { "name": "Options", "content": "" }, { "name": "-f= --file=", "content": "Read/Write package stats from the filename given with the parameter filename instead of\nfrom the default location, which is extendedstates in the directory defined by the\nConfiguration Item: Dir::State.\n" } ] }, "PREVENT CHANGES FOR A PACKAGE": { "content": "", "subsections": [ { "name": "hold", "content": "hold is used to mark a package as held back, which will prevent the package from being\nautomatically installed, upgraded or removed.\n" }, { "name": "unhold", "content": "unhold is used to cancel a previously set hold on a package to allow all actions again.\n" }, { "name": "showhold", "content": "showhold is used to print a list of packages on hold in the same way as for the other\nshow commands.\n" }, { "name": "SCHEDULE PACKAGES FOR INSTALL, REMOVE AND PURGE", "content": "Some front-ends like apt-get dselect-upgrade can be used to apply previously scheduled\nchanges to the install state of packages. Such changes can be scheduled with the install,\nremove (also known as deinstall) and purge commands. Packages with a specific selection can\nbe displayed with showinstall, showremove and showpurge respectively. More information about\nthese so called dpkg selections can be found in dpkg(1).\n" } ] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-h --help", "content": "Show a short usage summary.\n", "flag": "-h", "long": "--help" }, { "name": "-v --version", "content": "Show the program version.\n", "flag": "-v", "long": "--version" }, { "name": "-c --config-file", "content": "Configuration File; Specify a configuration file to use. The program will read the\ndefault configuration file and then this configuration file. If configuration settings\nneed to be set before the default configuration files are parsed specify a file with the\nAPTCONFIG environment variable. See apt.conf(5) for syntax information.\n", "flag": "-c", "long": "--config-file" }, { "name": "-o --option", "content": "Set a Configuration Option; This will set an arbitrary configuration option. The syntax\nis -o Foo::Bar=bar. -o and --option can be used multiple times to set different options.\n", "flag": "-o", "long": "--option" } ] }, "FILES": { "content": "/var/lib/apt/extendedstates\nStatus list of auto-installed packages. Configuration Item: Dir::State::extendedstates.\n", "subsections": [] }, "SEE ALSO": { "content": "apt-get(8),aptitude(8),apt.conf(5)\n", "subsections": [] }, "DIAGNOSTICS": { "content": "apt-mark returns zero on normal operation, non-zero on error.\n", "subsections": [] }, "BUGS": { "content": "APT bug page[1]. If you wish to report a bug in APT, please see\n/usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.\n", "subsections": [] }, "AUTHORS": { "content": "", "subsections": [ { "name": "Mike O'Connor", "content": "" }, { "name": "APT team", "content": "" } ] }, "NOTES": { "content": "1. APT bug page\nhttp://bugs.debian.org/src:apt\n\n\n\nAPT 2.4.14 11 December 2018 APT-MARK(8)", "subsections": [] } } } }