mirror of
https://github.com/isjerryxiao/pacroller.git
synced 2024-11-14 20:32:24 +08:00
update readme
This commit is contained in:
parent
9af2567ab3
commit
9ee0414bff
1 changed files with 34 additions and 1 deletions
35
README.md
35
README.md
|
@ -1,3 +1,36 @@
|
||||||
# Pacroller
|
# Pacroller
|
||||||
|
The "Unattended Upgrades" for Arch Linux.
|
||||||
|
|
||||||
W.I.P.
|
## Concept
|
||||||
|
Parsing the output of pacman and pacman.log, searching for known patterns and notifying the user whether there is a potential error.
|
||||||
|
Currently the design is regex-based, any output that is unable to match a set of regex is reported back to the user.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
`yay -S pacroller`
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
pacroller has the following subcommands
|
||||||
|
```
|
||||||
|
run [-d --debug]
|
||||||
|
start an upgrade
|
||||||
|
if the upgrade fails or pacroller determines that human action is required,
|
||||||
|
pacroller writes an exception to the status database, and refuses to run again
|
||||||
|
without resetting its failure status.
|
||||||
|
status [-v --verbose] [-m --max <number>]
|
||||||
|
print details of a previous successful upgrade
|
||||||
|
fail-reset
|
||||||
|
reset the current failure status
|
||||||
|
```
|
||||||
|
There is also a systemd timer for scheduled automatic upgrades.
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
Pacroller reads `/etc/pacroller/config.json` on startup.
|
||||||
|
### custom sync commands
|
||||||
|
Pacroller can be configured to use custom sync commands, which allows the usage of a different set of mirrors when syncing the database. Enable the "custom_sync" option and write your custom `/etc/pacroller/sync.sh`.
|
||||||
|
### needrestart
|
||||||
|
If the "needrestart" option is enabled, needrestart should be called after a successful upgrade.
|
||||||
|
### hold packages
|
||||||
|
Put your hold packages in a json keyval {package name: regex}, where the regex should have at least one matching group.
|
||||||
|
If pacroller observes any changes of the matching group or the hold package is to be removed, it refuses to upgrade further.
|
||||||
|
### ignored pacnew
|
||||||
|
A list of pacnew files that are silently ignored during parsing, any other pacnews will trigger a waring and prevent further upgrades.
|
||||||
|
|
Loading…
Reference in a new issue