pi ip refer

Command Help

> pi ip refer -h
Usage: pi ip refer [-h] [--force] [--all] [ip [ip ...]]

Description: Switch an IP to refer mode. An IP in a workspace can be in
"refer" or "local" mode. In refer mode the IP is a link to the PI replication
area. In local mode there is a local, editable copy of the IP.

Positional arguments:
  ip           The IP to switch to refer mode.

Optional arguments:
  --all, -a    Switch all IP to refer mode.
  --force, -f  Discard any unmanaged files in the local IP.
  --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. 					
  -h, --help   Show this help message and exit

Examples:
# Convert all IP in the workspace to refer mode
  pi ip refer --all

# Convert the single IP lib1.ip1 to refer mode
  pi ip refer lib1.ip1

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

Examples

> pi ip refer tutorial.tutorial tutorial.padring
Switching 'tutorial.padring@1.TRUNK, tutorial.tutorial@6.TRUNK' to refer mode.
Successfully switched 'tutorial.padring@1.TRUNK, tutorial.tutorial@6.TRUNK' to refer mode.