NAME

portsreinstall-upgrade - Support utility for portsreinstall(8) to update a target environment using packages built in a builder environment

SYNOPSIS

portsreinstall-upgrade [ OPTIONS ] [ -- ] [ command ]

DESCRIPTION

This utility applies updates of packages to a target environment using packages built in a builder environment. The executable file of this utility is installed outside the scope of the search paths, and dispatched from the builder environment to target environments by portsreinstall packupgrade create command followed by portsreinstall packupgrade crop command.

ROBUSTNESS AGAINST TERMINATION AND RESTART

Execution of this utility can be terminated at any points and restarted from there with the same options saved in the temporary database (independent among utilities). The saved options can be changed by the ways depending on the assigned groups of the options. The options and execution progress are reset to the default by running with -R option.

ARGUMENTS

One of the following commands can be given for optional operations or confirmation.

do: (Default) Apply the update of packages.
clean
clean [normal]: Clean up the temporary database.
clean force: Attempt to clean up the temporary database without checking the lock and privilege.
options: Show saved option settings and expected effects of option-resetting options -M. With -a option, the first, second and third columns denote the option-resetting options, reset options and remaining options, respectively.

OPTIONS

If duplicated or conflicting ones are set, the last ones are effective. The end of options can be explicitly specified by --. Short options can be given in compact forms, for example, -V -a to be -Va.

*NOTE*: Option settings are loaded from the saved configuration (independent of portsreinstall(8)) unless explicitly reset by -M option. The saved options can be checked by portsreinstall-upgrade options command.

Group 1: Just show messages and exit without operation

-H

--long-help: Show a long help whose content is the same as the manual page.

-h

--help
--short-help: Show a short help.

-V

--show-version: Show the current version.

Group 2: Effective anytime

-a

--batch-mode: Suppress messages so as to be friendly for batch operations. Comments are suppressed as much as possible. It is noted that log output in build/installation processes are not suppressed.

-M

--reset-minor-options: Reset option settings for minor controls. Option settings for group 4 are once reset and replaced with the newly specified ones. Check the saved options by portsreinstall options command before specifying this option.

-S

--no-opening-message: Suppress the credit, opening and terminating messages. Option -a takes higher priority over this option.

Group 3: Saved and transferred to restarted runs, renewable by -M option

Option settings in this group are saved at the first do or prepare run, and transferred to the following runs. Reset of the saved values for this group is available by appending -M with newly specified options.

-c

--suppress-cleaning-obsolete-database: Suppress cleaning the temporary database even if its obsolete. This option suppresses the default behavior that the temporary database is automatically cleaned up if it is older than the ports tree or portsreinstall itself is to be upgraded. Use of this option may cause unexpected results and basically unrecommended.

-n

--dry-run: No operation is carried out (just for seeing what will be done). This option is effective for do command so that no deinstallation and (re)installation process is actually carried out. By this option, ports/packages to be deinstalled or (re)installed can be confirmed without making changes to the current situation of packages.

Group 4: Saved and not renewable until cleaning

-P

--packages-dir: Specifies the directory where packages created by the builder environment are located. The default is ${PACKAGES}/${PKGREPOSITORYSUBDIR} by default (which is usually /usr/ports/packages/All).

DETAILS

Overview

This utility is a supporting tool of portsreinstall(8) to apply packages updates to a target environment using packages built by a builder environment using portsreinstall packupgrade create command followed by portsreinstall packupgrade crop command. On-the-fly smart entire upgrade of all installed ports and robustness against termination/restart is pursued by this tool.

The update proceeds from the lowest level of the dependence hierarchy to the highest, where for each port the old version and conflicts are first deinstalled and then the new version is installed. Obsolete and leaf ports are deinstalled at the final stage.

ENVIRONMENT VARIABLES

See the corresponding section of portsreinstall(8). The variables are conveyed to the forked environment from the target host.

HISTORY

This utility first appeared as a part of portsreinstall(8) version 4.0.0 released on June 29, 2018.

COPYRIGHT

This software is distributed under the 2-Clause BSD License.

Email: sakaue.mamoru@samurai.mwghennn.net

Homepage: http://www.mwghennndo.com/software/portsreinstall/