Files
BastilleBSD_bastille/usr/local/share/man/man1/bastille-etcupdate.1
tschettervictor b60af850c9 Finish man pages
2025-12-06 23:19:19 -07:00

131 lines
2.8 KiB
Groff

.Dd 2025/12/06
.Dt bastille-etcupdate 1
.Os
.Sh NAME
.Nm bastille etcupdate
.Nd Update /etc for jail(s).
.Sh SYNOPSIS
.Nm
.Op Fl fx
.Sy bootstrap
.Ar RELEASE
.Nm
.Op Fl dx
.Ar TARGET
.Sy update
.Ar RELEASE
.Nm
.Op Fl x
.Ar TARGET
.Sy diff|resolve
.Sh DESCRIPTION
The
.Nm
sub-command will bootstrap a tarball from
.Ar RELEASE
which can then be used to update the contents of
.Pa /etc
inside jails after performing an upgrade.
.Bl -tag -width Ds
.It Sy bastille etcupdate Oo Fl fx Oc Sy bootstrap Ar RELEASE
.Bl -tag -width Ds
.It Sy bootstrap
Bootstrap the 'src' archives for
.Ar RELEASE ,
then create a tarball from it. The tarball makes it
much easier and faster to apply to jails.
.It Fl f , Fl -force
Force a re-bootstrap of a release.
.It Fl x , Fl -debug
Enable debug mode.
.El
.It Sy bastille etcupdate Oo Fl dx Oc Ar TARGET Sy update Ar RELEASE
.Bl -tag -width Ds
.It Sy update
Update the contents of
.Pa /etc
inside
.Ar TARGET ,
using
.Ar RELEASE
as the base.
.Ar RELEASE
must first be bootstrapped.
.It Fl d , Fl -dry-run
Show output, but do not apply.
.It Fl x , Fl -debug
Enable debug mode.
.El
.Pp
The
.Ar RELEASE
specified here is the release you want to use as the base of
your
.Ar TARGET
/etc contents.
.It Sy bastille etcupdate Oo Fl x Oc Ar TARGET Sy diff|resolve
.Bl -tag -width Ds
.It Sy diff
Compare and show changes to
.Pa /etc
inside the
.Ar TARGET .
.It Sy resolve
Resolve any conflicts for
.Pa /etc
inside
.Ar TARGET .
Sometimes when performing the
.Nm
sub-command, it leaves
some conflicts between the old and new files. Use this option
to resolve these conflicts.
.It Fl x , Fl -debug
Enable debug mode.
.Sh EXAMPLES
.Bl -tag -width Ds
.It Bootstrap 15.0-RELEASE for use with etcupdate:
.Sy bastille etcupdate bootstrap 15.0-RELEASE
.It Update /etc for myjail to 15.0-RELEASE:
.Sy bastille etcupdate myjail 15.0-RELEASE
.It Resolve any conflicts left over for myjail:
.Sy bastille etcupdate myjail resolve
.Sh SEE ALSO
.Xr bastille.conf 5 ,
.Xr bastille-bootstrap 1 ,
.Xr bastille-clone 1 ,
.Xr bastille-cmd 1 ,
.Xr bastille-config 1 ,
.Xr bastille-console 1 ,
.Xr bastille-convert 1 ,
.Xr bastille-cp 1 ,
.Xr bastille-create 1 ,
.Xr bastille-destroy 1 ,
.Xr bastille-edit 1 ,
.Xr bastille-export 1 ,
.Xr bastille-htop 1 ,
.Xr bastille-import 1 ,
.Xr bastille-jcp 1 ,
.Xr bastille-limits 1 ,
.Xr bastille-list 1 ,
.Xr bastille-migrate 1 ,
.Xr bastille-mount 1 ,
.Xr bastille-network 1 ,
.Xr bastille-pkg 1 ,
.Xr bastille-rcp 1 ,
.Xr bastille-rdr 1 ,
.Xr bastille-rename 1 ,
.Xr bastille-restart 1 ,
.Xr bastille-service 1 ,
.Xr bastille-setup 1 ,
.Xr bastille-start 1 ,
.Xr bastille-stop 1 ,
.Xr bastille-sysrc 1 ,
.Xr bastille-tags 1 ,
.Xr bastille-template 1 ,
.Xr bastille-top 1 ,
.Xr bastille-umount 1 ,
.Xr bastille-update 1 ,
.Xr bastille-upgrade 1 ,
.Xr bastille-verify 1 ,
.Xr bastille-zfs 1