{"id":173,"date":"2025-02-02T20:20:41","date_gmt":"2025-02-03T01:20:41","guid":{"rendered":"https:\/\/dpm.darkhorselinux.org\/?page_id=173"},"modified":"2025-02-02T22:47:06","modified_gmt":"2025-02-03T03:47:06","slug":"don-paths","status":"publish","type":"page","link":"https:\/\/dpm.darkhorselinux.org\/?page_id=173","title":{"rendered":"DON Paths"},"content":{"rendered":"\n

Configuration<\/h2>\n\n\n\n
\/etc\/don\/config<\/code><\/pre>\n\n\n\n
The main configuration file for DON.<\/p>\n\n\n\n
Repository Configurations<\/h2>\n\n\n\n
\/etc\/don.repos.d\/<repository_name>.repo<\/code><\/pre>\n\n\n\n
Each repository has a configuration file dedicated to it with various options.<\/p>\n\n\n\n
Download Cache<\/h2>\n\n\n\n
\/var\/cache\/don\/packages\/<repo_name>\/<package_name><\/code><\/pre>\n\n\n\n
Don downloads packages and caches them to reduce pull time and network load from redownloading.<\/p>\n\n\n\n
Repository Metadata Cache<\/h2>\n\n\n\n
\/var\/cache\/don\/repos\/<repo_name>\/metadata<\/code><\/pre>\n\n\n\n
Don caches the metadata it downloads from repositories so that frequent searches do not create request burdens on the repository, with the added benefit of improving response time.<\/p>\n\n\n\n
Transaction and Logistical Database<\/h2>\n\n\n\n
\/var\/lib\/don\/dondb<\/code><\/pre>\n\n\n\n
This stores transactions processed by DON as well as some base logistical information such as which repository which packages were downloaded from.<\/p>\n\n\n\n
This information is used, for example, rolling back sets of package upgrades to undo a recent system update.<\/p>\n\n\n\n
Lock File<\/h2>\n\n\n\n
\/var\/lock\/don.lock<\/code><\/pre>\n\n\n\n
The lock file ensures that only one transaction is processed at a time.<\/p>\n\n\n\n
Logging<\/h2>\n\n\n\n
\/var\/log\/don\/don.log\nSYSLOG<\/code><\/pre>\n\n\n\n
DON optionally logs to either (or both) syslog and\/or a main log file.<\/p>\n\n\n\n
Package Blacklist Directory<\/h2>\n\n\n\n
\/etc\/don\/blacklist.d\/<\/code><\/pre>\n\n\n\n
This directory contains .conf<\/code> files, each of which are a line-delimited list of regular expressions.  If a package meets this regular expression, DON will refuse to install it and will skip over it in updates.<\/p>\n\n\n\n
Be aware that should a package name your blacklisted package as a dependency in a transaction that DON will fail and refuse to install the package naming your package as a dependency.<\/p>\n\n\n\n
Blacklisted package detection occurs at the end of the dependency resolution stage.  Here’s an example of the workflow:<\/p>\n\n\n\n
Suppose you have blacklisted a package named apples<\/code>.  You have another package that depends on apples, called bananas<\/code>.  You run a don update<\/code>, which will update all packages on the system that have an available upgrade package.  DON<\/code> will:<\/p>\n\n\n\n
    \n
  1. Detect that bananas<\/code> has an update available.<\/li>\n\n\n\n
  2. During dependency resolution, discover that apples<\/code> is a dependency.<\/li>\n\n\n\n
  3. Detect that apples<\/code> is blacklisted.<\/li>\n\n\n\n
  4. Skip updating bananas<\/code>, and continue with the other updates.<\/li>\n\n\n\n
  5. At the end of the update process for all packages getting updated, warn the user that bananas<\/code> was skipped due to its dependency on a blacklisted package.<\/li>\n<\/ol>\n\n\n\n
    Be cautious when blacklisting packages, as it doesn’t just use package names, it uses regular expressions, so'.*'<\/code> will prevent you from doing much at all with packages on your system.  The expression matches against PROVIDES, REPLACES, and NAME.<\/p>\n
    [ EXPORT TO PDF ]<\/span><\/a><\/a><\/div>","protected":false},"excerpt":{"rendered":"
    Configuration The main configuration file for DON. Repository Configurations Each repository has a configuration file dedicated to it with various options. Download Cache Don downloads packages and caches them to reduce pull time and network load from redownloading. Repository Metadata Cache Don caches the metadata it downloads from repositories so that frequent searches do not … Continue reading DON Paths<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-173","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=\/wp\/v2\/pages\/173","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=173"}],"version-history":[{"count":12,"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=\/wp\/v2\/pages\/173\/revisions"}],"predecessor-version":[{"id":208,"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=\/wp\/v2\/pages\/173\/revisions\/208"}],"wp:attachment":[{"href":"https:\/\/dpm.darkhorselinux.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=173"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}