man/portsreinstall-upgrade.8

   1 .\" ==================================================================================
   2 .\" portsreinstall-upgrade(8) manual page
   3 .\" Copyright (C) 2018 Mamoru Sakaue, MwGhennndo, All Rights Reserved.
   4 .\" ==================================================================================
   5 .TH PORTSREINSTALL\-UPGRADE 8 "29 June 2018" "FreeBSD" "FreeBSD System Manager's Manual"
   6 .SH NAME
   7 portsreinstall\-upgrade \- Support utility for \fBportsreinstall\fR(8) to update a target environment using packages built in a builder environment
   8 .SH SYNOPSIS
   9 .B portsreinstall-upgrade
  10 [
  11 .I
  12 OPTIONS
  13 ] [
  14 .B
  15 \-\-
  16 ] [
  17 .I
  18 command
  19 ]
  20 .SH DESCRIPTION
  21 This utility applies updates of packages to a target environment using packages built in a builder environment.
  22 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 \fBportsreinstall packupgrade create\fR command followed by \fBportsreinstall packupgrade crop\fR command.
  23 .SH ROBUSTNESS AGAINST TERMINATION AND RESTART
  24 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 \fB\-R\fR option.
  25 .SH ARGUMENTS
  26 One of the following \fIcommands\fR can be given for optional operations or confirmation.
  27 .TP
  28 \fBdo\fR
  29 (Default) Apply the update of packages.
  30 .TP
  31 \fBclean\fR
  32 .PD 0
  33 .TP
  34 \fBclean [normal]\fR
  35 Clean up the temporary database.
  36 .TP
  37 \fBclean force\fR
  38 Attempt to clean up the temporary database without checking the lock and privilege.
  39 .TP
  40 \fBoptions\fR
  41 Show saved option settings and expected effects of option-resetting options \fB\-M\fR.
  42 With \fB\-a\fR option, the first, second and third columns denote the option-resetting options, reset options and remaining options, respectively.
  43 .TP
  44 .RE
  45 .SH OPTIONS
  46 If duplicated or conflicting ones are set, the last ones are effective.
  47 The end of options can be explicitly specified by \fB\-\-\fR.
  48 Short options can be given in compact forms, for example, \fB\-V \-a\fR to be \fB\-Va\fR.
  49 .PD
  50 .TP
  51 \fB*NOTE*\fR
  52 Option settings are loaded from the saved configuration (independent of \fBportsreinstall\fR(8)) unless explicitly reset by \fB\-M\fR option.
  53 The saved options can be checked by \fBportsreinstall-upgrade options\fR command.
  54 .PD
  55 .SS Group 1: Just show messages and exit without operation
  56 .IP \fB\-H\fR
  57 .PD 0
  58 .TP
  59 \fB\-\-long\-help\fR
  60 Show a long help whose content is the same as the manual page.
  61 .PD
  62 .IP \fB\-h\fR
  63 .PD 0
  64 .TP
  65 \fB\-\-help\fR
  66 .PD 0
  67 .TP
  68 \fB\-\-short\-help\fR
  69 Show a short help.
  70 .PD
  71 .IP \fB\-V\fR
  72 .PD 0
  73 .TP
  74 \fB\-\-show\-version\fR
  75 Show the current version.
  76 .PD
  77 .SS Group 2: Effective anytime
  78 .IP \fB\-a\fR
  79 .PD 0
  80 .TP
  81 \fB\-\-batch\-mode\fR
  82 Suppress messages so as to be friendly for batch operations.
  83 Comments are suppressed as much as possible.
  84 It is noted that log output in build/installation processes are not suppressed.
  85 .PD
  86 .IP \fB\-M\fR
  87 .PD 0
  88 .TP
  89 \fB\-\-reset\-minor\-options\fR
  90 Reset option settings for minor controls.
  91 Option settings for group 4 are once reset and replaced with the newly specified ones.
  92 Check the saved options by \fBportsreinstall options\fR command before specifying this option.
  93 .PD
  94 .IP \fB\-S\fR
  95 .PD 0
  96 .TP
  97 \fB\-\-no\-opening\-message\fR
  98 Suppress the credit and opening messages.
  99 Option \fB\-a\fR takes higher priority over this option.
 100 .PD
 101 .SS Group 3: Saved and transferred to restarted runs, renewable by \-M option
 102 Option settings in this group are saved at the first \fBdo\fR or \fBprepare\fR run, and transferred to the following runs.
 103 Reset of the saved values for this group is available by appending \fB\-M\fR with newly specified options.
 104 .IP \fB\-c\fR
 105 .PD 0
 106 .TP
 107 \fB\-\-suppress\-cleaning\-obsolete\-database\fR
 108 Suppress cleaning the temporary database even if its obsolete.
 109 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.
 110 Use of this option may cause unexpected results and basically unrecommended.
 111 .PD
 112 .IP \fB\-n\fR
 113 .PD 0
 114 .TP
 115 \fB\-\-dry\-run\fR
 116 No operation is carried out (just for seeing what will be done).
 117 This option is effective for \fBdo\fR command so that no deinstallation and (re)installation process is actually carried out.
 118 By this option, ports/packages to be deinstalled or (re)installed can be confirmed without making changes to the current situation of packages.
 119 .PD
 120 .SS Group 4: Saved and not renewable until cleaning
 121 .IP \fB\-P\fR
 122 .PD 0
 123 .TP
 124 \fB\-\-packages\-dir\fR
 125 Specifies the directory where packages created by the builder environment are located.
 126 The default is ${PACKAGES}/${PKGREPOSITORYSUBDIR} by default (which is usually /usr/ports/packages/All).
 127 .PD
 128 .SH DETAILS
 129 .SS Overview
 130 This utility is a supporting tool of \fBportsreinstall\fR(8) to apply packages updates to a target environment using packages built by a builder environment using \fBportsreinstall packupgrade create\fR command followed by \fBportsreinstall packupgrade crop\fR command.
 131 On-the-fly smart entire upgrade of all installed ports and robustness against termination/restart is pursued by this tool.
 132 .PP
 133 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.
 134 Obsolete and leaf ports are deinstalled at the final stage.
 135 .PD
 136 .SH "ENVIRONMENT VARIABLES"
 137 See the corresponding section of \fBportsreinstall\fR(8).
 138 The variables are conveyed to the forked environment from the target host.
 139 .SH HISTORY
 140 See the corresponding section of \fBportsreinstall\fR(8).
 141 This utility first appeared in \fBportsreinstall\fR(8) version 4.0.0.
 142 .SH "SEE ALSO"
 143 \fBportsreinstall\fR(8),
 144 \fBportsreinstall\-chroot\fR(8),
 145 \fBportsreinstall\-chroot\-mount\fR(8).
 146 .SH COPYRIGHT
 147 This software is distributed under the 2-Clause BSD License.
 148 .PP
 149 (C)\ 2018\ Mamoru\ Sakaue,\ MwGhennndo,\ All\ Rights\ Reserved.
 150 .PP
 151 Email:\ sakaue.mamoru@samurai.mwghennn.net
 152 .PP
 153 Homepage:\ http://www.mwghennndo.com/software/portsreinstall/