Load a temporary database archive.
Note that the currently temporary database is removed.
.TP
-\fBglob\fR \fIglob\fR [\fIglob2\fR ...]
-Evaluate port globs and show matched flavored origins both for installed and uninstalled packages.
-.TP
-\fBoptions\fR
-Show saved option settings and expected effects of option-resetting options \fB\-L\fR, \fB\-M\fR and \fB\-N\fR.
-With \fB\-a\fR option, the first, second and third columns denote the option-resetting options, reset options and remaining options, respectively.
-.TP
\fBrmconf\fR \fIglob\fR [\fIglob2\fR ...]
Reset port options for the specified ports to the default and reset affected parts in the temporary database.
.TP
This command is provided for cases that ports/packages are reinstalled or reconfigured during/after the execution of \fBpackupgrade\fR \fBcreate\fR command.
After execution of this command, \fBpackupgrade\fR \fBcreate\fR command will overwrite the packages by creating them again.
.TP
+\fBmake\fR \fIglob\fR [\fItarget\fR ...] [\fIarguments\fR ...]
+Execute \fBmake\fR(1) command for ports matching the glob pattern.
+The taget and arguments are passed as they are with the arguments and environment variables customized for each port.
+For flavored ports, the appropriate argument (FLAVOR variable) is automatically set.
+The main purpose of this command is diagnosis and experimental build of unsuccessful ports.
+The result of this command will not be recognized by the (re)installation processes of \fBdo\fR and \fBredo\fR commands.
+The execution is carried out for each matching port in the alphanumeric order.
+If any port failed to execute \fBmake\fR(1) command, its exit status is returned by terminating immediately (so the following ports in the queue are skipped).
+.TP
+\fBglob\fR \fIglob\fR [\fIglob2\fR ...]
+Evaluate port globs and show matched flavored origins both for installed and uninstalled packages.
+The exit status is always 0.
+.TP
+\fBpkg\fR \fIglob\fR [\fIglob2\fR ...]
+Evaluate port globs and show matched installed package names.
+The returned exit status is 1 if no installed package matches any of the globs.
+.TP
+\fBoptions\fR
+Show saved option settings and expected effects of option-resetting options \fB\-L\fR, \fB\-M\fR and \fB\-N\fR.
+With \fB\-a\fR option, the first, second and third columns denote the option-resetting options, reset options and remaining options, respectively.
+.TP
\fBshow\fR [\fIsubject\fR] [@[\fBrun\fR|\fBbuild\fR|\fBall\fR][,[\fBdirect\fR|\fBfull\fR]]] [\fIarguments\fR]
Show the list of ports to be reinstalled.
The applied scope of dependencies can be controlled by "show option" proceeded by "@"; \fBrun\fR, \fBbuild\fR and \fBall\fR employ the run\-time, build\-time or both-time ones, respectively; \fBdirect\fR and \fBfull\fR include only the direct or fully recursive ones, respectively.
Conflicting ports which are temporarily deleted.
With \fB\-a\fR option, the first, second and third columns denote the flavored origin, initial/new/current package name, and opponent ports concatenated by comma respectively.
.TP
+\fBleaves\fR [\fBselected\fR | \fBunselected\fR]
+All detected leaf ports.
+Keywords \fBselected\fR and \fBunselected\fR are for filtering only selected (to be deleted) and unselected (to be preserved) ones, respectively.
+With \fB\-a\fR option, the first, second and third columns denote the flavored origin, initial/new/current package name, and opponent ports concatenated by comma respectively.
+.TP
+\fBobsolete\fR [\fBselected\fR | \fBunselected\fR]
+All detected obsolete ports.
+Keywords \fBselected\fR and \fBunselected\fR are for filtering only selected (to be deleted) and unselected (to be preserved) ones, respectively.
+With \fB\-a\fR option, the first, second and third columns denote the flavored origin, initial/new/current package name, and opponent ports concatenated by comma respectively.
+.TP
\fBrequirements\fR \fIglob1\fR [\fIglob2\fR ...]
Ports required by matching ports/packages.
With \fB\-a\fR option, the first, second, third and fourth columns denote the flavored origin of the queried port, initial/new/current package name of the queried port, flavored origin of a requirement of the queried port and initial/new/current package name of the requirement, respectively.
\fBstatus\fR \fIglob1\fR [\fIglob2\fR ...]
Current success/failure status in (re)installation of matching ports/packages.
Returned values are null, "todo", "done", "resolved", "failure", "redo", "taboo", "freeze", "need", "noneed", "restored", "deleted" or "conflict", where null means that they are untouched in the current option configuration or temporary reset due to configuration changes.
+.TP
+ \fBerrormessage\fR \fIglob1\fR [\fIglob2\fR ...]
+Error message in (re)installation of matching ports/packages.
+Returned values are null for successful or skipped ports/packages.
.RE
.SH OPTIONS
If duplicated or conflicting ones are set, the last ones are effective.
\fB\-\-exclude\-runtime\-dependencies\fR
Exclude run\-time dependencies in evaluation of dependencies.
This option affects behaviors of \fB\-t\fR, \fB\-T\fR and \fB\-q\fR options.
+Use of this option should be just for temporary diagnosis or salvage because the full-run-time requirements are needed for building a port in principle.
.PD
.IP \fB\-b\fR
.PD 0
\fB\-\-include\-buildtime\-dependencies\fR
Include build\-time dependencies in evaluation of dependencies.
This option affects behaviors of \fB\-t\fR, \fB\-T\fR and \fB\-q\fR options.
+Use of this option will result in installation of the all build-time requirements regardless of the actual necessity for upgrade of installed packages.
.PD
.IP \fB\-C\fR
.PD 0
Without \fB\-o\fR option, the temporary database is maintained to have complete data on dependencies of all installed and necessary ports.
Combination with options \fB\-T\fR and \fB\-t\fR is available.
The behavior can be modified by \fB\-B\fR, \fB\-b\fR, \fB\-i\fR and \fB\-o\fR options.
+Use of this option should be just for temporary diagnosis or salvage.
.PD
.IP \fB\-o\fR
.PD 0
Ports outside of the scopes are kept untouched even if they are updated.
It is noted that this option disables detection and deinstallation of new leaf ports.
This option will be useful for quick upgrades or new installation (only) before complete construction of the temporary database for the all installed ports.
+Use of this option should be just for temporary diagnosis or salvage.
.PD
.IP \fB\-T\fR\ \fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
.PD 0
Without \fB\-o\fR option, the temporary database is maintained to have complete data on dependencies of all installed and necessary ports.
Combination with options \fB\-T\fR and \fB\-t\fR is available.
The behavior can be modified by \fB\-B\fR, \fB\-b\fR, \fB\-i\fR and \fB\-o\fR options.
+Use of this option should be just for temporary diagnosis or salvage.
.PD
.IP \fB\-t\fR\ \fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
.PD 0
Without \fB\-o\fR option, the temporary database is maintained to have complete data on dependencies of all installed and necessary ports.
Combination with options \fB\-T\fR and \fB\-t\fR is available.
The behavior can be modified by \fB\-B\fR, \fB\-b\fR, \fB\-i\fR and \fB\-o\fR options.
+Use of this option should be just for temporary diagnosis or salvage.
.PD
.SS Group 6: Saved and transferred to restarted runs, renewable by \-L option
Option settings in this group are saved at the first \fBdo\fR or \fBprepare\fR run, and transferred to the following runs.
.SH HISTORY
\fBportsreinstall\fR has been developed as below.
.TP
-4.0.1 (?? July 2018)
+4.1.0 (?? August 2018)
.RS
[NEW] Option \fB\-x\fR is added.
.PP
+[NEW] Option \fB\-s\fR is added to \fBportsreinstall\-chroot\fR(8).
+.PP
+[NEW] \fBauto\fR command is added to \fBportsreinstall\-chroot\fR(8).
+.PP
+[NEW] \fBpkg\fR, \fBmake\fR, \fBshow errormessage\fR, \fBshow leaves\fR and \fBshow obsolete\fR commands are added.
+.PP
+[NEW] BUILDCONFLICT and INSTCONFLICT sections are added to ${LOCALBASE}/etc/portsreinstall.conf.
+.PP
+[IMPROVED] The (Re)installation scheme is changed to skip ports whose requirements are not installed at their turns, and always retry failed build.
+.PP
+[IMPROVED] It is changed to detect unflavored ports or ports with old flavor names of flavored ports as obsolete.
+.PP
+[IMPROVED] The behavior with union file systems is stabilized.
+.PP
[IMPROVED] It is changed to show messages of reset ports at the stage of reloading ${LOCALBASE}/etc/portsreinstall.conf.
.PP
+[IMPROVED] It is changed so that ports to freeze are upgraded to the latest available package version.
+.PP
+[IMPROVED] It is changed to unlock in all error termination.
+.PP
+[IMPROVED] Inside- and outside-parent jail/chroot mounting/unmounting operations by \fBportsreinstall\-chroot\fR(8) and \fBportsreinstall\-chroot\-mount\fR(8) are now safely protected from each other.
+.PP
+[IMPROVED] The message at the exit from \fBportsreinstall\-chroot\fR(8) builder chroot environment is modified to be less shocking.
+.PP
+[IMPROVED] The batch mode is made more quiet typically about the output of package tools and make.
+.PP
+[BUG FIX] Adding packages sometimes failed due to lack of required packages.
+.PP
+[BUG FIX] \fBreset\fR command discarded the information of the initially installed packages.
+.PP
+[BUG FIX] Dependency inspection might have terminated with error when obsolete ports exist.
+.PP
[BUG FIX] Changes made by commands or in ${LOCALBASE}/etc/portsreinstall.conf were not reflected to dependents of the specified ports in the redo runs with incorrect messages notifying as already inspected merged ports.
+.PP
+[BUG FIX] Unmounting of file systems by \fBportsreinstall\-chroot\fR(8) had some problems due to inclusion of redundant series of slashes in the path.
+.PP
+[BUG FIX] Evaluation of old origins was incomplete for merged ports and resulted in redundant detection of conflict.
+.PP
+[BUG FIX] Failure in unmounting of file systems by \fBportsreinstall\-chroot\fR(8) left the privilege lock.
+.PP
+[BUG FIX] Conflict was not correctly escaped in package installation.
+.PP
+[BUG FIX] Evaluation of globs was incorrect for the regular expression form.
+.PP
+[BUG FIX] Flavored requirements were incorrectly inspected. This also caused disability of the use of prebuilt official packages for flavord ports with the default configuration.
+.PP
+[BUG FIX] The message about the evaluated dependency level in \fBshow\fR command was wrong.
.RE
.TP
4.0.0 (29 June 2018)
OSDN Git Service
