Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions src/xbps/advanced-usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,39 @@ Then downgrade with `xbps-install`:
The `-f` flag is necessary to force downgrade/re-installation of an already
installed package.

## Holding packages

To prevent a package from being updated during a system update, use
[xbps-pkgdb(1)](https://man.voidlinux.org/xbps-pkgdb.1):

```
# xbps-pkgdb -m hold pkg
```

The hold can be removed with:

```
# xbps-pkgdb -m unhold pkg
```

## Repository-locking packages

If you've used `xbps-src` to build and install a package from a customized
template, or with custom build options, you may wish to prevent system updates
from replacing that package with a non-customized version. To ensure that a
package is only updated from the same repository used to install it, you can
*repolock* it via [xbps-pkgdb(1)](https://man.voidlinux.org/xbps-pkgdb.1):

```
# xbps-pkgdb -m repolock pkg
```

To remove the repolock:

```
# xbps-pkgdb -m repounlock pkg
```

## Ignoring Packages

Sometimes you may wish to remove a package whose functionality is being provided
Expand Down
2 changes: 2 additions & 0 deletions src/xbps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ Most general package management is done with the following commands:
package-specific versions that are selected by the user.
- [xbps-pkgdb(1)](https://man.voidlinux.org/xbps-pkgdb.1) can report and fix
issues in the package database, as well as modify it.
- [xbps-rindex(1)](https://man.voidlinux.org/xbps-rindex.1) manages local binary
package repositories.

Most questions can be answered by consulting the man pages for these tools,
together with the [xbps.d(5)](https://man.voidlinux.org/xbps.d.5) man page.
Expand Down