FreeBSD Manual Pages
PORTSREI...-UPGRADE(8) FreeBSD System Manager's Manual PORTSREI...-UPGRADE(8) 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 util- ity is installed outside the scope of the search paths, and dispatched from the builder environment to target environments by portsreinstall packup- grade 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 (indepen- dent among utilities). The saved options can be changed by the ways depend- ing 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 con- firmation. 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 de- note the option-resetting options, reset options and remaining op- tions, respectively. OPTIONS If duplicated or conflicting ones are set, the last ones are effec- tive. 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 com- mand. 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. Com- ments are suppressed as much as possible. It is noted that log out- put 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 specify- ing 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 op- tion, ports/packages to be deinstalled or (re)installed can be con- firmed 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 envi- ronment are located. The default is ${PACKAGES}/${PKGREPOSITORYSUB- DIR} 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 environ- ment using portsreinstall packupgrade create command followed by portsrein- stall packupgrade crop command. On-the-fly smart entire upgrade of all in- stalled 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 con- veyed 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. SEE ALSO portsreinstall(8), portsreinstall-chroot(8), portsreinstall-ch- root-mount(8). COPYRIGHT This software is distributed under the 2-Clause BSD License. (C) 2018 Mamoru Sakaue, MwGhennndo, All Rights Reserved. Email: sakaue.mamoru@samurai.mwghennn.net Homepage: http://www.mwghennndo.com/software/portsreinstall/ FreeBSD 20 April 2022 PORTSREI...-UPGRADE(8)
NAME | SYNOPSIS | DESCRIPTION | ROBUSTNESS AGAINST TERMINATION AND RESTART | ARGUMENTS | DETAILS | ENVIRONMENT VARIABLES | HISTORY | SEE ALSO | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=portsreinstall-upgrade&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>