Perforce Helix Core Server Command Reference

https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef
Admin
Perforce Helix Core Server is a version control and code review platform that provides comprehensive...
Tokens:217,143
Snippets:3,660
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Client Syntax Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/filespecs.html

Specifies a file in client syntax, starting with '//' followed by the workspace name and path.

```shell
//myworkspace/file.c
```

--------------------------------

### Depot Syntax Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/filespecs.html

Specifies a file in depot syntax, starting with '//' followed by the depot name and path.

```shell
//depot/source/module/file.c
```

--------------------------------

### Configure P4COLORS examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/P4COLORS.html

Examples of setting P4COLORS for different output levels and field-specific styling.

```text
P4COLORS=@info=0:@warning=1;33;40:@error=1;31;40
```

```text
P4COLORS=(user=jsmith)@info=1;35;40
```

```text
P4COLORS=depotFile=1;36
```

--------------------------------

### Create Extension Sample

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Generates a sample P4 Extension to get started. Replace _extName_ with your desired extension name.

```bash
p4 extension --sample  _extName_
```

--------------------------------

### Example: View Specific Configurable Value

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example shows how to view the value of a specific configurable variable, 'monitor', and indicates how it was set.

```bash
p4 configure show monitor
```

--------------------------------

### Example: Configurable set by p4d startup option

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example shows a configurable variable that was set using a command-line option during the p4d server startup.

```bash
P4PORT=20192 (-p)
```

--------------------------------

### Example: View Configurable Values on All Servers

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example demonstrates how to view configuration variables across all servers, including those defined for 'any' server and specific named servers.

```bash
p4 configure show allservers
```

--------------------------------

### p4 dirs Examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_dirs.html

Common usage examples for listing subdirectories in the depot.

```text
p4 dirs //depot/projects/*
```

```text
p4 dirs //depot/projects/*/*
```

```text
p4 dirs //depot/a/* //depot/b/*
```

```text
p4 dirs -i //depot/read*
```

--------------------------------

### Basic p4 fstat usage examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_fstat.html

Common command-line examples for retrieving file status information.

```bash
p4 fstat file.c
```

```bash
p4 fstat //....c@20,@now
```

```bash
p4 fstat -Os file.c
```

```bash
p4 fstat -Osl file.c
```

```bash
p4 fstat -Os -Ol file.c
```

```bash
p4 fstat -F "clientFile=c:\\ws\\file.c" 		  //depot/main/...
```

```bash
p4 fstat -F "clientFile~=c:\\ws\\[Ff]ile.c" 		  //depot/main/...
```

```bash
p4 fstat -Ol -F "fileSize < 1024 & 		  headType=text" //depot/main/...
```

```bash
p4 fstat -T 'depotFile, headRev' file.c
```

```bash
p4 fstat -On -F attr-preview //depot/main/rel1/perl_proj/..
```

--------------------------------

### Install Packaged Extension

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Use --install to install a packaged Extension file server-side. The --yes option is required to perform the installation; without it, the command only reports what it would do.

```bash
p4 extension --install _ExtName_.p4-extension --yes
```

--------------------------------

### Example: Configurable set by p4 serverid

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example shows a configurable variable that was set using the 'p4 serverid' command.

```bash
serverid=commit (serverid)
```

--------------------------------

### Example: Setting Configurable with p4 configure set

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example demonstrates setting a configurable variable using the 'p4 configure set' command, which provides persistent configuration.

```bash
net.parallel.max: 10 (configure)
```

--------------------------------

### Example: Configurable set by p4d -v option

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example shows a configurable variable that was set using the '-v' option during the p4d server startup.

```bash
monitor=2 (-v)
```

--------------------------------

### Example: Setting Configurable via Environment Variable (Unix)

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

This example shows how to set a server-related configurable using the 'export' command on Unix. Note that this method does not persist across sessions.

```bash
export P4PORT=20192
```

--------------------------------

### Example p4 aliases output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_aliases.html

This example shows the typical output format for the 'p4 aliases' command, illustrating various custom alias definitions.

```bash
p4 aliases
co => edit
ci => submit
st => status
shelved => changes -s shelved -u $(P4USER) -c $(P4CLIENT)
pending =>  changes -s pending -u $(P4USER) -c $(P4CLIENT)
desc => describe -s
purge => clean -I
blame => annotate -u
delete-shelf $(change) => shelve -dc $(change) &&
                        revert -c $(change) //... &&
                        change -d $(change)
newChange $(desc) => change -o > $(chg) &&
                     p4subst  "$(LT)enter.*$(GT)" $(desc) < $(chg) > $(chg2) &&
                     change  -i < $(chg2)
```

--------------------------------

### Overlay Mapping Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_client.html

Use the + sign to map multiple server directories to the same client workspace directory.

```text
//depot/project1/...     //bruno-client/project/...  
+//depot/project2/...    //bruno-client/project/...
```

--------------------------------

### Install Unsigned Extension

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Use --allow-unsigned to install an extension without requiring it to be signed, equivalent to setting 'server.extensions.allow.unsigned=1'.

```bash
p4 extension --install _ExtName_.p4-extension --yes --allow-unsigned
```

--------------------------------

### Hotfiles mapping examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_hotfiles.html

This example demonstrates various ways to define hotfiles mappings, including specifying depot paths, filetypes, and size constraints. Paths can be repeated for different rules.

```text
HotFiles:  
    //depot/project1/...   
    //depot/project2/... text  
    //depot/project3/... <50K  
    //depot/project4/... text+C <100K  
    //depot/project4/... binary <1M
```

--------------------------------

### Install P4 Extension

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Installs a P4 Extension from a .p4-extension file. The --yes flag bypasses confirmation.

```bash
p4 extension --install _extName_.p4-extension [--yes]
```

--------------------------------

### List Installed Extensions and Configurations

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Use --list to display installed extensions and their instances. Filter by --type (extensions, configs, global, instance) or --path for path-based instances.

```bash
p4 extension --list --type extensions
```

```bash
p4 extension --list --type configs
```

```bash
p4 extension --list --type global
```

```bash
p4 extension --list --type instance
```

```bash
p4 extension --list --path //depot/...
```

--------------------------------

### Combined p4 opened options

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_opened_graph.html

Example demonstrating the combination of options. This specific example lists files opened by a user in a specific workspace, limited to a maximum number of results.

```bash
p4 opened -a -c _change_ -C _workspace_ -u _user_ -m _max_ -s [_file_ ...]

```

--------------------------------

### Example p4 resolved Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_resolved.html

An example of how the output might look, showing a file that was merged from a specific depot path and revision range.

```text
my/local/file.txt - merge from //depot/main/file.txt#1-5
```

--------------------------------

### Example output for p4 have on a graph depot

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_have_graph.html

This example shows the typical output of 'p4 have' for a graph depot, including the repository, workspace, commit SHA, and branch name. It also illustrates how file-specific revisions are displayed when they differ from the branch commit.

```text
//graphDepot1/repo1 workspace1 b78d7fb2e8c50e refs/heads/branch
File specific revisions:
workspace1  readme.txt  3a16b5c563e01a
workspace1  index.html  3a16b5c563e01a
workspace1  eiffel-tower.png  f2d7b9b83a49d
```

--------------------------------

### Example of p4 graph verify Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_graph_verify.html

This example shows the typical output format when verifying a repository. Each line represents a file, displaying its computed SHA1 and its location within the repository's object storage.

```bash
p4 graph verify -n //gd1/repo1
e69de29bb2d1d6434b8b29ae775ad8c2 gd1/repo1.git/objects/e6/9de29bb2d1d6434b8b29ae775ad8c2
```

--------------------------------

### Example: Default Logstat Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_logstat.html

This example shows the typical output when running 'p4 logstat' without any options, displaying the sizes of the journal and 'out' log.

```bash
C:\temp\logs> p4 logstat
journal 2591 bytes
out 126 bytes
```

--------------------------------

### Example Resolve Prompt and Automated Resolution

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_resolve.html

This example demonstrates the interactive prompt during a merge and how automated resolution options like 'at' (accept theirs) or 'ay' (accept yours) can be used to handle different types of conflicts, such as filetype changes or moves.

```text
Merging //depot/rel/fileb#1
Diff chunks: 1 yours + 0 theirs + 0 both + 0 conflicting
Accept(a) Edit(e) Diff(d) Merge (m) Skip(s) Help(?) ay: m
//depot/main/filez - resolve skipped.
Resolving move to //depot/main/fileb
Filename resolve:
 at: //depot/main/fileb
 ay: //depot/main/filez
```

--------------------------------

### Example P4MERGE Paths

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/P4MERGE.html

Illustrates potential paths for the p4merge executable on Windows.

```shell
c:\Perforce\p4merge.exe
```

```shell
c:\progra~1\Perforce\p4merge.exe
```

--------------------------------

### Get Help for a Specific Graph Command

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help-graph.html

To get detailed information about a particular graph depot command, specify the command name after 'p4 help-graph'. For example, to get help for the 'add' command.

```bash
p4 help-graph add
```

```bash
p4 help-graph switch
```

--------------------------------

### List Repositories with Name Filter

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_repos.html

Use the `-e` option to filter repositories by name pattern. This example lists repos where the depot name starts with 'gra' and the repo name starts with 'rep'.

```bash
p4 repos -e //gra.../rep...
```

--------------------------------

### Example Cherry-Pick Execution and Result

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/introduction.aliases.complex.html

Demonstrates how to execute the complex cherry-pick alias and the resulting Perforce commands.

```bash
p4 cherry-pick 1015978 two one "line a merged into one"
```

```bash
p4 integrate //depot/two/...@1015978,1015978 //depot/one/...
p4 resolve -am -Ac //depot/one/...
p4 submit -d "Cherry-pick change https://swarm.perforce.com/@1015978[1015978]
              from //depot/two/... to //depot/one/..."
p4 sync
```

--------------------------------

### Example p4 set Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_set.html

Sample output showing variable values and their respective definition sources.

```text
P4CLIENT=symlinks-nix (config)  
P4CONFIG=p4config.txt (config '/home/perforce/p4clients/symlinks-nix/p4config.txt')  
P4EDITOR=/usr/bin/vi  
P4IGNORE=p4ignore.txt (enviro)  
P4PORT=win-bruno:20151 (config)  
P4USER=bruno (set -s)  
P4_20151_CHARSET=none (set)  
```

--------------------------------

### Example: Sync and check have revision

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_have.html

This example demonstrates syncing a specific revision of a file and then using 'p4 have' to confirm the revision currently in the client workspace. The first 'p4 have' shows the highest revision copied, and the second 'p4 have' confirms the specific revision synced.

```bash
p4 sync //depot/name/...#4
p4 have //depot/name
```

--------------------------------

### Client View Mapping Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/views.html

Demonstrates how a client view maps depot files to workspace files, showing how later mappings override earlier ones.

```text
//depot/...		//ws/...
```

```text
//depot/dir/...	//ws/dir2/...
```

--------------------------------

### Example Protection Table Configuration

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_protect.html

This example shows a protection table configuration with multiple users and access levels. It defines permissions for 'alice' and 'bob' on different depot paths and grants 'super' access globally.

```Perforce Protection Table
list user * * -//... 
write user alice * //depot/dev/... 
write user alice * //depot/main/... 
write user bob * //depot/dev/... 
open user bob * //depot/main/... 
super user super * //...
```

--------------------------------

### Get Current Version of Specified Tables

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_dbschema.html

To get the current schema for specific tables, list their names after the `p4 dbschema` command. Table names correspond to files starting with `db.` in the P4 Server root directory.

```bash
p4 dbschema db.rev db.have
```

--------------------------------

### Filter Keys by Name

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_keys.html

Lists keys whose names match the specified pattern. For example, to list all keys starting with 'mycounter-'.

```bash
p4 keys -e 'mycounter-*'
```

--------------------------------

### Create and switch to a branch on all repos

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_switch_graph.html

This example shows how to create a new branch and switch all associated repositories to that branch using the -c and -a options.

```bash
p4 switch -c -a   branch2
```

--------------------------------

### Filter Counters by Name

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_counters.html

Lists counters whose names match the specified pattern. For example, to list all counters starting with 'mycounter-'.

```bash
p4 counters -e 'mycounter-*'
```

--------------------------------

### Display all versions of CommandStart record type

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_logschema.html

This example displays all versions for the tagged output of the CommandStart record type, including version 0 and version 50.

```bash
p4 logschema -A 0
```

--------------------------------

### Wildcard: //gra*/dep*

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/filespecs.html

Matches depot paths starting with 'gra' and 'dep'. This example illustrates matching across directory names.

```shell
//gra*/dep*
```

--------------------------------

### List all opened files in depot syntax

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_opened.html

This example demonstrates listing all files under a specific depot path using depot syntax. This is useful for checking the status of files in a particular project or directory within the depot.

```bash
p4 opened -a //depot/project1/...
```

--------------------------------

### Filter and Limit Counters

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_counters.html

Combines filtering by name pattern and limiting the number of results. This example lists the first 10 counters that start with 'build-'.

```bash
p4 counters -e 'build-*' -m 10
```

--------------------------------

### Display General Help for P4 Server

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help.html

Use this command without arguments to list all available 'p4 help' options and topics.

```bash
p4 help
```

--------------------------------

### Filter and Limit Keys

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_keys.html

Combines filtering by name pattern with a limit on the number of keys displayed. For example, to list a maximum of 5 keys that start with 'test-'.

```bash
p4 keys -e 'test-*' -m 5
```

--------------------------------

### Set Server Configurable via Command Line

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/appendix.configurables.html

Use command-line options with `p4d` to set server configurables at startup. This method is not persistent.

```bash
p4d -v net.keepalive.idle=2700
```

--------------------------------

### Add users to a group

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_pubkey.html

Example of adding users to a specified group using the `p4 group` command. This is part of the setup required for users to manage their SSH keys.

```bash
**p4 group repoUsers**
```

--------------------------------

### Changelist Details (Z-Tag Output)

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_describe.html

Example output of 'p4 -ztag describe' showing detailed changelist information in a structured format. Each line starts with '... ' followed by a tag and its value.

```bash
... change 2  
... user bruno  
... client brn123  
... time 1546621943  
... desc x  
... status pending  
... changeType public  
... stream //root/main
```

--------------------------------

### Access field example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_stream.html

Example format for the Access field in a stream specification.

```text
Access:	2023/11/06 17:20:55
```

--------------------------------

### p4 login2 Syntax Examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_login2.html

Demonstrates the various syntaxes for the p4 login2 command, including options for multi-factor authentication persistence, status display, restarting MFA, and forwarding authentication to remote servers.

```bash
p4 login2 [ -p -R ] [ -h  _host_ ] [ -S _state_ ] [ -m _method_ ] [ _username_ ]
```

```bash
p4 login2 -s [ -a | -h _host_ ] [ _username_ ]
```

```bash
p4 login2 [-p] -r _remotespec_ [--remote-user=_X_]
```

```bash
p4 login2 [-s -a] -r _remotespec_ [--remote-user=_X_]
```

--------------------------------

### Example status output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_pull.html

A concrete example of the status output for file transfers.

```text
File transfers: 1 active/63 total, bytes: 745 active/23684 total.
```

--------------------------------

### Set a Server Startup Configuration

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

Sets a specific startup script for a named server. This example configures 'Replica1' to pull data every second.

```bash
p4 configure set "Replica1#startup.1=pull -i 1"
```

--------------------------------

### Get Help on P4 Server Configurables

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help.html

This command describes the usage of all P4 Server configuration variables.

```bash
p4 help configurables
```

--------------------------------

### Install P4 Extension Certificate

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Installs a certificate for a P4 Extension. Includes an optional comment.

```bash
p4 extension --install _certificateFile_ --cert [ --comment ]
```

--------------------------------

### Initialize a new P4 Server

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_init.html

Initializes a new P4 Server personal server. This command sets up the necessary files and directories for a local P4 Server instance.

```bash
p4 init
```

--------------------------------

### Get Help on a Specific P4 Keyword

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help.html

Use this command with a keyword to get help on that specific topic.

```bash
p4 help _keyword_
```

--------------------------------

### Create Extension Skeleton

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Use --sample to create a skeleton of a new Extension in a directory. Pass it the name of the Extension to be created.

```bash
p4 extension --sample _ExtName_
```

--------------------------------

### DistributedConfig Form Example with Indentation

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/specification-forms.html

Shows an example of a 'DistributedConfig' field in a specification form, demonstrating indented values.

```text
DistributedConfig:  
    P4TARGET=host7:1234  
    track=1  


```

--------------------------------

### Example Configuration History Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

Illustrates the typical output format of the 'p4 configure history' command, showing configuration variable changes.

```text
any#dm.user.setinitialpasswd changed from 'unset' to '0' (iteration 1) by 'usuper' on 2022/10/17 01:54:55 local to server NoServerId with comment 'security'
any#server.allowfetch changed from 'unset' to '1' (iteration 2) by 'usuper' on 2023/10/20 10:22:55 local to server NoServerId
any#server.allowfetch changed from '1' to 'unset' (iteration 3) by 'usuper' on 2023/10/31 17:28:45 local to server NoServerId with comment 'unset fetch'
```

--------------------------------

### Get Help on a Specific P4 Command

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help.html

Use this command with a command name to get specific help for that command.

```bash
p4 help _command_
```

--------------------------------

### Get Introduction to P4 Streams

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help.html

This command explains what streams are in P4 Server and lists commands typically used with them.

```bash
p4 help streamintro
```

--------------------------------

### P4TARGET Examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/P4TARGET.html

Examples of valid P4TARGET values, including port numbers, hostnames with ports, and IP addresses with ports.

```text
1818
```

```text
london:11111
```

```text
perforce.example.com:1234
```

```text
192.168.0.123:1818
```

--------------------------------

### Basic p4 integrate Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_integrate.html

The simplest syntax for integrating changes from one file to another. If the target file does not exist, it's copied. If it exists, it's opened for integration, requiring 'p4 resolve'.

```bash
p4 integrate _fromFile toFile_
```

--------------------------------

### List all client workspaces (not just local)

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_clients.html

Use the -a option to list all client workspaces, not just those bound to the current server.

```bash
p4 clients -a
```

--------------------------------

### Example Audit Log Entries

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/P4AUDIT.html

These are example lines from the P4 Server audit log, illustrating the format for 'diff' and 'sync' commands.

```text
2025/06/09 09:52:45 maria@mgonzales-ws1 192.168.0.12 diff //depot/src/x.c#1
2025/06/09 09:54:13 emily@emonti-ws2 127.0.0.1 sync //depot/inc/file.h#1
```

--------------------------------

### Show File Locations

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_where.html

Example of using p4 where to display the depot, client workspace, and local filesystem locations for a specific file.

```bash
p4 where file.c
```

--------------------------------

### Example Updated Configuration History Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

Shows the 'p4 configure history' output after a comment has been added to a specific iteration.

```text
any#dm.user.setinitialpasswd changed from 'unset' to '0' (iteration 1) by 'usuper' on 2022/10/17 01:54:55 local to server NoServerId with comment 'security'
any#server.allowfetch changed from 'unset' to '1' (iteration 2) by 'usuper' on 2023/10/20 10:22:55 local to server NoServerId with comment 'for DVCS'
any#server.allowfetch changed from '1' to 'unset' (iteration 3) by 'usuper' on 2023/10/31 17:28:45 local to server NoServerId with comment 'unset fetch'
```

--------------------------------

### Install a Fingerprint

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_trust.html

Use the `-i` option to install a specified fingerprint into the `P4TRUST` file. This is necessary when manually adding a server's fingerprint.

```bash
p4 trust -i "_fingerprint_"
```

--------------------------------

### Configure Extension

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_extension.html

Use --configure to activate an Extension by creating its instance configuration. The _extFQN_ is the fully-qualified name (namespace:name[:revision]). The --revision option specifies which depot version to configure. Use -o to write the definition to stdout and -i to read from stdin.

```bash
p4 extension --configure _extFQN_ [ --revision=_n_ ] [ -o | -i ]
```

```bash
p4 extension --configure _ExampleInc_::_myExt_
```

```bash
p4 extension --configure myCompany::fileSizeCheck
```

```bash
p4 extension --configure _myCompany_::_extName_ --name Release1.0-fileSizeCheckInst
```

--------------------------------

### Purge file content examples

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_obliterate.html

Examples of using the -p option to remove file content while preserving metadata for specific date ranges.

```text
p4 obliterate -p -y file@2015/01/01,2019/01/01
```

```text
p4 obliterate -p -y //depot/some/path/...@2015/01/01,2019/01/01
```

--------------------------------

### Example P4 Info Output

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_info.html

This is an example of the output generated by the `p4 info` command, showing various details about the Perforce server configuration.

```text
Client name: myserver-24-n102
Client host: myserver-24-n102.dhcp.perforce.com
Client unknown.
Current directory: /Users/kharris
Peer address: 10.0.102.24:52492
Client address: 10.0.102.24
Server address: someaddress.perforce.com:1999
Server root: /depots/p4-1999
Server date: 2025/07/13 14:52:59 -0700 PDT
Server uptime: 147:34:34
Server version: P4D/LINUX26X86_64/2025.2.MAIN-TEST_ONLY/1199094 (2025/07/07)
ServerID: london1999
Server services: standard
Server license: 500 users (expires 2027/01/31)
Server license-ip: qaplay.perforce.com
Case Handling: sensitive
```

--------------------------------

### DistributedConfig Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_server.html

Example of setting non-default values for distributed configuration in Perforce Helix Core Server. This includes setting P4TARGET and track options.

```shell
DistributedConfig:
  P4TARGET=host7:1234
  track=1
```

--------------------------------

### p4 branch View Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_branch.html

Illustrates how to define a branch view, mapping files from one depot location to another. Comments can be added using '##'.

```bash
View:
         ## Comment line
        //depot/main/...  //depot/r2.1  ## comment appended
```

--------------------------------

### Display CommandStart record type

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_logschema.html

This example displays the tagged output for the CommandStart record type of the commands.csv log file.

```bash
p4 logschema 0
```

--------------------------------

### Get Tagged Output for Groups

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_groups.html

Use the -ztag option with p4 groups to get tagged output, which includes the Description field and other group details.

```bash
p4 -ztag groups
```

--------------------------------

### Example filelog output before and after purging

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_obliterate.html

Demonstrates how filelog output changes when revisions are purged, showing the transition from 'edit/add' actions to 'purge' actions.

```text
... #3 change 2123 edit on 2019/12/04 by user1@dev1 (binary) 'Third version'
... #2 change 2115 edit on 2019/12/03 by user1@dev1 (binary) 'Second version'
... #1 change 2101 add on 2019/12/01 by user1@dev1 (binary) 'First version'
```

```text
... #3 change 2123 edit on 2019/12/04 by user1@dev1 (binary) 'Third version'
... #2 change 2115 purge on 2019/12/03 by user1@dev1 (binary) 'Second version'
... #1 change 2101 purge on 2019/12/01 by user1@dev1 (binary) 'First version'
```

--------------------------------

### Configure background task on server startup

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_bgtask.html

Configure a background task to run automatically upon server startup using the startup.N configurable. This example sets up the 'log_checker' task.

```bash
startup.1=bgtask -t log_checker
```

--------------------------------

### Starting P4D with Journal File

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/P4JOURNAL.html

This command-line alternative specifies the journal file when starting the P4D server. It is the server-side equivalent of setting the P4JOURNAL variable.

```bash
p4d -J _file_
```

--------------------------------

### Example output for a deleted stream

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_streamlog.html

This example shows the output format when reporting on a deleted stream, indicating the changelist number and action (delete, edit, add).

```text
... change 789 delete on 2022/03/03 by maria@mgwksp 'Stream //project1/s1'
```

--------------------------------

### Display Help for p4 configure

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_configure.html

Provides help information for the p4 configure command.

```bash
p4 configure help
```

--------------------------------

### LDAP Search Bind Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_ldap.html

This example demonstrates the fields required for an LDAP search bind method, including the base DN, search filter, and scope.

```text
BaseDN: ou=users,dc=example,dc=org
LDAP query: (uid=%user%)
```

--------------------------------

### Grouped Diff Options Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_diff.html

Demonstrates how to pass multiple diff options by grouping them together. This example specifies a unified diff that ignores changes in whitespace.

```bash
p4 diff -dub file
```

--------------------------------

### Get Help on P4 Extension Options

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help.html

This command describes the options available for 'p4 extension'. Refer to 'p4 help serverextensionintro' and 'p4 help clientextensionintro' for more information on extensions.

```bash
p4 help extension
```

--------------------------------

### Simple Command Alias Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/introduction.syntax.alias.html

An example of renaming the 'files' command to 'fiches' for French users. This allows executing 'p4 fiches' to perform the 'files' command.

```shell
fiches = files
```

--------------------------------

### Get Help for Graph Depot Commands

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_help-graph.html

Use this command to view a list of all available commands for graph depots. This is the general entry point for graph depot help.

```bash
p4 help-graph
```

--------------------------------

### Display All References

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_show-ref.html

Use this command to display all references from all repositories. Requires 'super' access.

```bash
p4 graph show-ref -a
```

--------------------------------

### Get Help for p4 trust

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_trust.html

Use `p4 trust -h` to get help for the trust command. This command is implemented on the client, so help must be requested locally.

```bash
p4 trust -h
```

--------------------------------

### Multiple Directory Mapping Example

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_client.html

Use the & sign to map a single server directory to multiple client workspace directories; note that these files are read-only.

```text
//depot/...     //bruno-client/...  
&//depot/and/tools/... //bruno-client/and/utility1/...  
&//depot/and/tools/... //bruno-client/and/utility2/...
```

--------------------------------

### Example: Structured Logstat Output with -s

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/p4_logstat.html

This example demonstrates the output when using the 'p4 logstat -s' command, which lists the sizes of all structured log files, including 'all.csv' and 'commands.csv'.

```bash
C:\temp\logs> p4 logstat -s
journal 2591 bytes
out 255 bytes
all.csv 13599 bytes
commands.csv 11321 bytes
path/to/log/files/all.csv 13599 bytes
```

--------------------------------

### Example Usage of Clone Alias

Source: https://help.perforce.com/helix-core/server-apps/cmdref/current/Content/CmdRef/introduction.aliases.basic.html

Illustrates how to use the 'clone' alias defined previously, specifying the P4 port, depot path, and local directory.

```bash
clone perforce:1666 //depot/main/p4...  ~/local-repos/main
```
Tokens:
Raw