53 lines
1.4 KiB
Groff
53 lines
1.4 KiB
Groff
.Dd $Mdocdate: May 5 2022 $
|
|
.Dt PKGSET 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm pkgset
|
|
.Nd manage system packages in a declarative way
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Sh DESCRIPTION
|
|
.Pp
|
|
.Nm
|
|
is a program to manage the installed packages on the system in a
|
|
declarative way.
|
|
.Pp
|
|
.Nm
|
|
will check the packages declared but not installed, and will install them.
|
|
Packages installed but not declared will be set as "auto
|
|
installed", meaning they will be deleted at the end of the process
|
|
if they are not a dependency of a listed packages.
|
|
.Sh FILES
|
|
Create a list of packages in
|
|
.Pa /etc/pkgset.conf
|
|
or add files to
|
|
.Pa /etc/pkgset.conf.d/
|
|
directory for include.
|
|
.Pp
|
|
Packages should be listed one per line and can be written in a format recognized by
|
|
.Xr pkg_add 1
|
|
, see BUGS for more explanations about flavors or version syntax.
|
|
.Sh EXAMPLES
|
|
The file
|
|
.Pa /etc/pkgset.conf
|
|
is used to define a few packages on this system, note the various syntax available
|
|
to define a package version or a flavor.
|
|
.Bd -literal -offset indent
|
|
borgbackup--%1.2
|
|
vim--no_x11
|
|
xfce
|
|
rlwrap
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr pkg_add 1
|
|
.Sh HISTORY
|
|
This software tries to make OpenBSD more declarative and ease system administrator work.
|
|
.Sh AUTHORS
|
|
.An See the LICENSE file for the authors .
|
|
.Sh LICENSE
|
|
See the LICENSE file for the terms of redistribution.
|
|
.Sh BUGS
|
|
Some packages may not be installed if you don't specify the version or flavor, like vim or borgbackup because
|
|
.Xr pkg_add 1
|
|
will tell the package is ambiguous when looking for a match.
|