pi ip list
Command Help
> pi ip list -h
Usage: pi ip list [-h] [--format {csv,json,long,table,template} | --verbose]
[--model MODEL] [--all | --max MAX] [--limit LIMIT]
[--contents] [--label LABEL [LABEL ...]]
[--match-substring MATCH_SUBSTRING | --query QUERY | --squery SQUERY]
[identifier [identifier ...]]
Description: List all matching IP. A variety of format and filtering options
are supported.
Positional arguments:
identifier Filter IP by name.
Optional arguments:
--all, -a Include all IP Versions (IPVs), equivalent to --max 0.
--contents Display a list of all files and the version of each
file for the specified IP. This can generate a LOT of
output if an IP contains a large number of files.
--format {csv,json,long,table,template}
Return the results using the specified data structure.
The template format produces files that can be used by
the pi add|edit commands with the --template option.
--limit LIMIT Limit the output to the specified number of records
--match-substring MATCH_SUBSTRING, -m MATCH_SUBSTRING
Filter by matching substring. All fields in the output
are considered
--max MAX Include at most MAX IP Versions (IPVs).
--model MODEL Use the specified report model (table report only).
--query QUERY, -q QUERY
Filter using the Perforce IPLM Query Language.
--squery SQUERY, -sq SQUERY
Filter using a Saved Perforce IPLM Query.
--verbose, -v Alias for --format long.
-h, --help Show this help message and exit
Filters:
--label LABEL [LABEL ...]
Filter by IP Label.
Examples:
# List all latest versions of all IP
pi ip list
# List all latest versions of IP foo.bar
pi ip list foo.bar
# Show five most recent foo.bar versions
pi ip list --max 5 foo.bar
# List all latest versions of all IP in library foo
pi ip list foo.
More information and documentation available at:
https://help.perforce.com/methodics/
Copyright © 2010-2025 Perforce, Inc.
Examples
> pi ip list tutorial.tutorial ┌───────────────────────────┬────┬───────────────────────────┬────────────┬───────────────────────────────┬─────────────────┐ │ NAME │ DM │ ALIASES │ CREATED BY │ CREATED ON │ VERSION MESSAGE │ ╞═══════════════════════════╪════╪═══════════════════════════╪════════════╪═══════════════════════════════╪═════════════════╡ │ tutorial.tutorial@1.L1 │ P4 │ HEAD LATEST │ admin │ 2019-07-26 15:58:15 -0400 EDT │ hier release │ │ tutorial.tutorial@1.L2 │ P4 │ HEAD LATEST │ admin │ 2019-07-26 15:58:19 -0400 EDT │ hier release │ │ tutorial.tutorial@1.L3 │ P4 │ HEAD LATEST │ admin │ 2019-07-26 15:58:23 -0400 EDT │ hier release │ │ tutorial.tutorial@1.L4 │ P4 │ HEAD LATEST │ admin │ 2019-07-26 15:58:27 -0400 EDT │ hier release │ │ tutorial.tutorial@6.TRUNK │ P4 │ GOLD HEAD ISO26262 LATEST │ admin │ 2019-07-26 16:35:54 -0400 EDT │ adding fusa ip │ └───────────────────────────┴────┴───────────────────────────┴────────────┴───────────────────────────────┴─────────────────┘ Found 5 matching object(s).
> pi ip list tutorial.tutorial@.TRUNK -a ┌───────────────────────────┬────┬───────────────────────────┬────────────┬───────────────────────────────┬─────────────────┐ │ NAME │ DM │ ALIASES │ CREATED BY │ CREATED ON │ VERSION MESSAGE │ ╞═══════════════════════════╪════╪═══════════════════════════╪════════════╪═══════════════════════════════╪═════════════════╡ │ tutorial.tutorial@6.TRUNK │ P4 │ GOLD HEAD ISO26262 LATEST │ admin │ 2019-07-26 16:35:54 -0400 EDT │ adding fusa ip │ │ tutorial.tutorial@5.TRUNK │ P4 │ │ admin │ 2019-07-26 15:58:10 -0400 EDT │ hier release │ │ tutorial.tutorial@4.TRUNK │ P4 │ GOLD │ admin │ 2019-07-26 15:58:10 -0400 EDT │ hier release │ │ tutorial.tutorial@3.TRUNK │ P4 │ │ admin │ 2019-07-26 15:58:10 -0400 EDT │ hier release │ │ tutorial.tutorial@2.TRUNK │ P4 │ GOLD │ admin │ 2019-07-26 15:58:10 -0400 EDT │ hier release │ │ tutorial.tutorial@1.TRUNK │ P4 │ GOLD │ admin │ 2019-07-26 15:57:57 -0400 EDT │ hier release │ │ tutorial.tutorial@0.TRUNK │ P4 │ │ admin │ 2019-07-26 15:57:55 -0400 EDT │ Initial version │ └───────────────────────────┴────┴───────────────────────────┴────────────┴───────────────────────────────┴─────────────────┘ Found 7 matching object(s).
> pi ip list --contents tutorial.tutorial@5.TRUNK
IP Version tutorial.tutorial@5.TRUNK:
Description - Perforce IPLM tutorial project
DM type - Perforce (P4)
Host -
Repo Path - //mdx_test/tutorial/tutorial/TRUNK
Resources - tutorial.CADenv@GOLD.TRUNK [@1]
tutorial.analog_top@HEAD.TRUNK [@1]
tutorial.digital_top@1.TRUNK
tutorial.padring@1.TRUNK
tutorial.verif_config@1.TRUNK
Current Aliases -
Historic Aliases -
Version Message - hier release
IP created on - 2019-07-26 15:57:55 -0400 EDT by admin
Line created on - 2019-07-26 15:57:55 -0400 EDT by admin
IP Version created on - 2019-07-26 15:58:10 -0400 EDT by admin
Project Properties:
* - --mode both --path blocks/$IP
IP Properties:
BlockSize_latest - 0.32 mm2
BlockSize_target - 0.34 mm2
CMRR_latest - 107.0 dB
CMRR_target - 112.0 dB
INL_latest - 18.5 ppm
INL_target - 20.0 ppm
NIR_latest - 463.0 nVRMS
NIR_target - 490.0 nVRMS
PSRR_latest - 110.0 dB
PSRR_target - 101.0 dB
PowerHigh_latest - 1.55 mW
PowerHigh_target - 1.6 mW
PowerNominal_latest - 1.35 mW
PowerNominal_target - 1.4 mW
Supply_target - 1.2 V
TempHi_target - 125.0 C
TempLow_target - -55.0 C
Vio_latest - 3.5 uV
Vio_target - 6.0 uV
auth_required - N
compliance_cond - SOC-SPV-13
compliance_specs - SOC-SPV-14
external_ip - N
fclk_target - 1.2 MHz
internal_ipid - INTERN6578W
ip_lifecycle - owned
jama_object - SOC-STY-16
jama_project - SoCSouthBridge
jama_url - 7wbq.jamacloud.com
license_agreement - INTERNAL
license_class - B
owner - BU356
process_name - MS90G
process_node - 90
review_version - 1
target_power - 0.5 mW (*)
target_size - 35.0 sq-mm
vendor_id - INTERNAL
vendor_ipid - INTERNAL
IP Version Properties:
BlockSize_rel - 0.34 mm2
BlockSize_verif - 0.32 mm2
CMRR_rel - 112.0 dB
CMRR_verif - 106.0 dB
INL_rel - 20.0 ppm
INL_verif - 19.0 ppm
NIR_rel - 490.0 nVRMS
NIR_verif - 475.0 nVRMS
PSRR_rel - 101.0 dB
PSRR_verif - 108.0 dB
PowerHigh_rel - 1.6 mW
PowerHigh_verif - 1.7 mW
PowerNominal_rel - 1.4 mW
PowerNominal_verif - 1.35 mW
Supply_rel - 1.2 V
TempHi_rel - 125.0 C
TempLow_rel - -55.0 C
Vio_rel - 6.0 uV
Vio_verif - 3.5 uV
coverage - 76.0 %
fclk_rel - 1.2 MHz
power - 47.0 mW
regr - 1929 /2000
size - 37.0 sq-mm
Permissions on IP:
Owner - u:ada u:alan
Write Permissions - u:ada u:alan
Read Permissions - g:tutorial u:ada u:alan
Permissions on Line TRUNK:
Owner - u:ada u:alan
Write Permissions - u:ada u:alan
Read Permissions - g:tutorial u:ada u:alan
Hooks:
Post-Release - /var/tmp/ISO26262_release_hook.py $LIB $IP $VER $LINE
Contents:
Files
doc/hw_design/blg_checklist.xlsx#1
doc/hw_verify/blg_bug.xlsx#1
hw_code/code/mt48lc32m16a2.v#1
hw_code/code/test.v#1
hw_code/filelist/blg.f#1
hw_code/report/blg.rpt#1
hw_code/report/statlinecount#1
hw_code/test/test.v#1
sw_code/driver/blg_driver.7z#1
sw_code/test/blg_driver_test.7z#1
Found 1 matching object(s).