pi update

Command Help

> pi update -h
Usage: pi update [-h] [--wsdir WSDIR] [--args ARGS]
                 [--force | --keep-local | --promote] [--dry-run]
                 [--verbose] [ip]

Description: Update a Workspace. This can be used to update any or all of the
resources in the current Workspace.

Positional arguments:
  ip                    The IP Version to update. By default, the top IP
                        Version of the Workspace will be used.

Optional arguments:
  --args ARGS           Arguments passed to the hooks.
  --dry-run, -n         Report on updates that would result, without actually
                        making any changes to the Workspace.
  --force, -f           Update a Workspace to precisely reflect a release. All
                        resources are updated to the version in the release.
  --keep-local, -k      Update the Workspace to a release, while retaining
                        local changes made to files and resources.
  --promote, -p         Update the Workspace to a release, while retaining
                        local changes made to files and resources, unless a
                        released version of a file or resource is greater than
                        the version in the Workspace. In that case, use the
                        released version of the file or resource. This is the
                        default behavior.
  --unload MODE 	Specify handling of IPVs that will be unloaded from the workspace.
			MODE is integer 0-2: 
			0 (default) - block unload for open files, 
			1 - block unload for open+modified files (unmodified files will be reverted), 
			2 - same as 1 but unopened modified files will be backed up to BACKUP_DIR.
			Higher mode number gives lower performance.
  --verbose, -v         Display file version level changes resulting from the
			workspace update.							
  --wsdir WSDIR, -ws WSDIR
                        The Workspace directory. If not specified, the current
                        directory should be a Workspace directory.
  -h, --help            Show this help message and exit

More information and documentation available at:
  https://help.perforce.com/methodics/
Copyright © 2010-2025 Perforce, Inc.

Example

> pi up padring
Updating Workspace. For large IP this could take a while.
┌──────────────────┬─────────────┬─────────────┬───────┬────────────────┐
│ NAME             │ OLD VERSION │ NEW VERSION │  MODE │ PATH           │
╞══════════════════╪═════════════╪═════════════╪═══════╪════════════════╡
│ tutorial.padring │   1.TRUNK   │   5.TRUNK   │ Local │ blocks/padring │
└──────────────────┴─────────────┴─────────────┴───────┴────────────────┘