Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PORTSREINSTALL-UPGRADE(8FreeBSD	System Manager's ManuPORTSREINSTALL-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			       22 September 2018     PORTSREINSTALL-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://www.freebsd.org/cgi/man.cgi?query=portsreinstall-upgrade&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help