FreeBSD Manual Pages
PORTSREI...-UPGRADE(8) FreeBSD System Manager's Manual PORTSREI...-UPGRADE(8) NAME portsreinstall-upgrade - Support utility for portsreinstall(8) to up- date 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 dis- patched from the builder environment to target environments by portsre- install packupgrade create command followed by portsreinstall packup- grade 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 (inde- pendent among utilities). The saved options can be changed by the ways depending on the assigned groups of the options. The options and execu- tion 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-reset- ting 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 ef- fective. 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 (inde- pendent of portsreinstall(8)) unless explicitly reset by -M op- tion. The saved options can be checked by portsreinstall-up- grade 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 unrecom- mended. -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 deinstalla- tion 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}/${PKGREPOS- ITORYSUBDIR} by default (which is usually /usr/ports/pack- ages/All). DETAILS Overview This utility is a supporting tool of portsreinstall(8) to apply pack- ages 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 up- grade 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. 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.0>