Querying Libraries in the system

See how to use the Perforce IPLM query language to query Libraries within the Perforce IPLM platform.

Command line

Libraries are listed using the 'pi library list' command. More information can be found on the Listing Libraries in the System page. 

Details on the use of the Perforce IPLM query language and Saved queries can be found on their respective pages.

Library related fields for use in queries

  • attributes (list of attributes)

  • creation_timestamp (integer)

  • creator (user)

  • description (string)

  • fqn (string): the FQN of the Library, e.g. chipsets.

  • hook_post_load (string)

  • hook_post_release (string)

  • hook_post_update (string)

  • hook_pre_release (string)

  • ips (list of IPs)

  • labels (list of labels)

  • name (string): the name of the Library, e.g. chipsets

  • vendor (string)


Libraries by Library name with Wildcard 
> pi lib list -q 'name*="AR*"'
┌──────┬────────┬─────────────┬────────┐
│ NAME │ VENDOR │ DESCRIPTION │ LABELS │
╞══════╪════════╪═════════════╪════════╡
│ ARM  │ ARM    │ ARM Library │ shared │
└──────┴────────┴─────────────┴────────┘
Found 1 matching object(s).

Libraries by Creator Name 
> pi lib list -q 'creator*="admin"'
┌────────────────┬───────────┬──────────────────────────────────────────┬─────────┐
│ NAME           │ VENDOR    │ DESCRIPTION                              │ LABELS  │
╞════════════════╪═══════════╪══════════════════════════════════════════╪═════════╡
│ ARM            │ ARM       │ ARM Library                              │ shared  │
│ Data-Converter │ XiTera    │ Data-Converter Library                   │         │
│ Mem            │ XiTera    │ Memory Library                           │ shared  │
│ PDK            │ Perforce │ PDK IPs                                  │ shared  │
│ PLL            │ XiTera    │ PLL Library                              │         │
│ certification  │ internal  │ platform certification library           │         │
│ tutorial       │ Perforce │ The Perforce tutorial SoC project, a    │ project │
│                │           │ mixed signal automotive project based on │         │
│                │           │ TMS 90nm technology                      │         │
└────────────────┴───────────┴──────────────────────────────────────────┴─────────┘

Libraries by Absolute Creation Time 
> pi lib ls -q 'creation_timestamp < datetime(2019,11,29) && creation_timestamp > datetime(2019,11,1)'
┌────────────────┬───────────┬──────────────────────────────────────────┬─────────┐
│ NAME           │ VENDOR    │ DESCRIPTION                              │ LABELS  │
╞════════════════╪═══════════╪══════════════════════════════════════════╪═════════╡
│ ARM            │ ARM       │ ARM Library                              │ shared  │
│ tutorial       │ Perforce │ The Perforce tutorial SoC project, a    │ project │
│                │           │ mixed signal automotive project based on │         │
│                │           │ TMS 90nm technology                      │         │
└────────────────┴───────────┴──────────────────────────────────────────┴─────────┘
Found 2 matching object(s).

All Libraries with Label1 or Label2 Attached 
> pi lib ls -q 'any(labels, {it = "project" or it = "analog"})'
┌──────────┬───────────┬──────────────────────────────────────────┬─────────┐
│ NAME     │ VENDOR    │ DESCRIPTION                              │ LABELS  │
╞══════════╪═══════════╪══════════════════════════════════════════╪═════════╡
│ tutorial │ Perforce │ The Perforce tutorial SoC project, a    │ project │
│          │           │ mixed signal automotive project based on │         │
│          │           │ TMS 90nm technology                      │         │
└──────────┴───────────┴──────────────────────────────────────────┴─────────┘
Found 1 matching object(s).

Find All Libraries with a Particular Attribute Name 
> pi lib ls  -q 'any(attributes, {it.name=="FAQ"})'
┌──────────┬───────────┬──────────────────────────────────────────┬─────────┐
│ NAME     │ VENDOR    │ DESCRIPTION                              │ LABELS  │
╞══════════╪═══════════╪══════════════════════════════════════════╪═════════╡
│ tutorial │ Perforce │ The Perforce tutorial SoC project, a    │ project │
│          │           │ mixed signal automotive project based on │         │
│          │           │ TMS 90nm technology                      │         │
└──────────┴───────────┴──────────────────────────────────────────┴─────────┘
Found 1 matching object(s).