Differential D21473 Diff 62326 usr.sbin/freebsd-update/freebsd-update.8

Changeset View

Standalone View

usr.sbin/freebsd-update/freebsd-update.8

	Show All 19 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
	.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING			.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
	.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE			.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
	.\" POSSIBILITY OF SUCH DAMAGE.			.\" POSSIBILITY OF SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd June 14, 2017			.Dd September 19, 2019
	.Dt FREEBSD-UPDATE 8			.Dt FREEBSD-UPDATE 8
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm freebsd-update			.Nm freebsd-update
	.Nd fetch and install binary updates to FreeBSD			.Nd fetch and install binary updates to FreeBSD
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Fl b Ar basedir			.Op Fl b Ar basedir
	▲ Show 20 Lines • Show All 53 Lines • ▼ Show 20 Lines
	Force			Force
	.Nm Cm fetch			.Nm Cm fetch
	to proceed in the case of an unfinished upgrade.			to proceed in the case of an unfinished upgrade.
	.It Fl k Ar KEY			.It Fl k Ar KEY
	Trust an RSA key with SHA256 of			Trust an RSA key with SHA256 of
	.Ar KEY .			.Ar KEY .
	(default: read value from configuration file.)			(default: read value from configuration file.)
	.It Fl r Ar newrelease			.It Fl r Ar newrelease
	Specify the new release (e.g., 11.2-RELEASE) to which			Specify the new release (e.g., 11.2-RELEASE) to which
				emasteUnsubmitted Done Inline Actions Committed this bit in rS352513 emaste: Committed this bit in rS352513
	.Nm			.Nm
	should upgrade (upgrade command only).			should upgrade (upgrade command only).
	.It Fl s Ar server			.It Fl s Ar server
	Fetch files from the specified server or server pool.			Fetch files from the specified server or server pool.
	(default: read value from configuration file.)			(default: read value from configuration file.)
	.It Fl t Ar address			.It Fl t Ar address
	Mail output of			Mail output of
	.Cm cron			.Cm cron
	▲ Show 20 Lines • Show All 43 Lines • ▼ Show 20 Lines
	Before using this command, make sure that you read the			Before using this command, make sure that you read the
	announcement and release notes for the new release in			announcement and release notes for the new release in
	case there are any special steps needed for upgrading.			case there are any special steps needed for upgrading.
	Note that this command may require up to 500 MB of space in			Note that this command may require up to 500 MB of space in
	.Ar workdir			.Ar workdir
	depending on which components of the			depending on which components of the
	.Fx			.Fx
	base system are installed.			base system are installed.
				.It Cm updatesready
				Check if there are fetched updates ready to install.
				Returns exit code 2 if there are no updates to install.
	.It Cm install			.It Cm install
	Install the most recently fetched updates or upgrade.			Install the most recently fetched updates or upgrade.
				Returns exit code 2 if there are no updates to install
				jillesUnsubmitted Not Done Inline Actions The usual convention if there is both a "false" status and an error status is that "false" is 1 and errors are 2 or higher. (If there is no "false", errors are often just 1.) This seems to switch that around. jilles: The usual convention if there is both a "false" status and an error status is that "false" is 1…
				gremboAuthorUnsubmitted Done Inline Actions Based on that observation, which exit codes would you suggest? grembo: Based on that observation, which exit codes would you suggest?
				gremboAuthorUnsubmitted Done Inline Actions Like, change all occurrences of "exit 1" to "exit 2" and make those two "exit 1" instead? grembo: Like, change all occurrences of "exit 1" to "exit 2" and make those two "exit 1" instead?
				and the
				.Cm fetch
				command wasn't passed as an earlier argument in the same
				invocation.
	.It Cm rollback			.It Cm rollback
	Uninstall the most recently installed updates.			Uninstall the most recently installed updates.
	.It Cm IDS			.It Cm IDS
	Compare the system against a "known good" index of the			Compare the system against a "known good" index of the
	installed release.			installed release.
				.It Cm showconfig
				Show configuration options after parsing conffile and command
				line options.
	.El			.El
	.Sh TIPS			.Sh TIPS
	.Bl -bullet			.Bl -bullet
	.It			.It
	If your clock is set to local time, adding the line			If your clock is set to local time, adding the line
	.Pp			.Pp
	.Dl 0 3 * * * root /usr/sbin/freebsd-update cron			.Dl 0 3 * * * root /usr/sbin/freebsd-update cron
	.Pp			.Pp
	Show All 28 Lines