P4 Command Reference2018.1

March 2018

Copyright 1999-2018 Perforce Software.

All rights reserved.

Perforce Software and documentation is available fromwww.perforce.com. You can download and use Perforce programs, butyou can not sell or redistribute them. You can download, print, copy, edit, and redistribute the documentation, but you can not sellit, or sell anydocumentation derived from it. You can not modify or attempt to reverse engineer the programs.

This product is subject to U.S. export control lawsand regulations including, but not limited to, the U.S. Export AdministrationRegulations, the International Traffic in ArmsRegulation requirements, and all applicable end-use, end-user and destinationrestrictions. Licensee shall not permit, directly or indirectly, use of anyPerforce technology in or byanyU.S. embargoed country orotherwise in violation of anyU.S. export control lawsand regulations.

Perforce programsand documents are available from our Web site as is. No warranty or support is provided.Warranties andsupport, along with higher capacity servers, are sold byPerforce Software.

Perforce Software assumesno responsibility or liability for anyerrors or inaccuracies that might appear in this book. Bydownloading and using our programsand documents you agree to these terms.

Perforce and Inter-File Branching are trademarksof Perforce Software.

All other brandsor product namesare trademarksor registered trademarksof their respective companiesor organizations.

Anyadditional software included within Perforce Software is listed in "License Statements" on page664.

https://www.perforce.com/

Contents

How to use this Guide 13Feedback 13

Other documentation 13

Syntax conventions 13

Whats new in this guide 142018.1 release 14

2017.2 release 16

New specification fields 16New commands 16New configurables 16Updated configurable 16

Technical Preview 17Second Factor Authentication 17

Graph Depot 17

Commands by functional area 18Graph depot commands 20Exclusive to graph depots 20

Behave differently for graph depots 20

Tech Preview 2017.2 for graph depots 21

Command-line Help for graph depots 22

Introduction 23Getting help 23

Command aliases 24

Defining aliases 24Command alias syntax 25Basic examples 27Complex examples 28Putting it all together 30Previewing alias substitutions 31Advanced topics 31Limitations 32

Naming conventions 32

Creating scripts 33

3

Commands andmetadata 33

Commands 35p4 add 36

p4 admin 40

p4 aliases 44

p4 annotate 46

p4 archive 49

p4 attribute 51

p4 bgtask 52

p4 branch 55

p4 branches 58

p4 cachepurge 60

p4 change 62

p4 changelist 68

p4 changelists 69

p4 changes 70

p4 clean 73

p4 client 75

p4 clients 89

p4 clone 91

p4 configure 93

p4 copy 97

p4 counter 100

p4 counters 103

p4 cstat 105

p4 dbschema 106

p4 dbstat 107

p4 dbverify 109

p4 delete 111

p4 depot 114

p4 depots 122

p4 describe 124

Examples 126

4

p4 diff 128

p4 diff2 132

p4 dirs 136

p4 diskspace 138

p4 edit 140

p4 export 143

p4 fetch 146

p4 filelog 151

p4 files 155

p4 fix 158

p4 fixes 161

p4 flush 163

p4 fstat 166

p4 graph tags 175

p4 graph show-ref 176

p4 grant-permission 177

p4 grep 181

p4 group 183

p4 groups 188

p4 have 190

p4 help 194

p4 ignores 196

p4 info 199

p4 init 201

p4 integrate 203

p4 integrated 209

p4 interchanges 213

p4 istat 215

p4 job 217

p4 jobs 220

p4 jobspec 226

p4 journalcopy 230

p4 journaldbchecksums 233

5

p4 journals 236

p4 key 240

p4 keys 243

p4 label 244

p4 labels 248

p4 labelsync 250

p4 ldap 252

p4 ldaps 259

p4 ldapsync 262

p4 license 266

p4 list 268

p4 lock 270

p4 lockstat 272

p4 logappend 274

Example 274p4 logger 276

p4 login 278

p4 login2 280

p4 logout 282

p4 logparse 284

p4 logrotate 286

p4 logschema 287

p4 logstat 288

p4 logtail 290

p4merge 292

p4monitor 295

p4move 301

p4 obliterate 303

p4 opened 306

p4 passwd 309

p4 ping 312

p4 populate 314

p4 print 316

6

p4 property 318

p4 protect 320

p4 protects 334

p4 proxy 336

p4 prune 337

p4 pubkey 339

p4 pubkeys 342

p4 pull 344

p4 push 350

p4 reconcile 354

p4 reload 357

p4 remote 359

p4 remotes 362

p4 rename 364

p4 renameuser 365

p4 reopen 368

p4 replicate 370

p4 repo 372

p4 repos 375

p4 reshelve 377

p4 resolve 379

Examples 386p4 resolved 387

p4 restore 389

p4 resubmit 391

p4 revert 394

p4 review 398

p4 reviews 400

p4 revoke-permission 402

p4 server 405

p4 serverid 412

p4 servers 414

p4 set 420

7

p4 shelve 423

p4 show-permission 427

p4 show-permissions 428

p4 sizes 430

p4 status 433

p4 stream 436

p4 streams 446

p4 submit 448

p4 switch 458

p4 sync 462

p4 tag 470

p4 tickets 472

Usage Notes 472p4 triggers 473

p4 trust 475

p4 typemap 477

p4 undo 481

p4 unload 483

p4 unlock 486

p4 unshelve 488

p4 unsubmit 490

p4 unzip 492

p4 update 495

p4 user 496

p4 users 502

p4 verify 504

p4 where 508

p4 workspace 510

p4 workspaces 511

p4 zip 512

Environment and Registry Variables 514P4ALIASES 515

Usage Notes 516

8

Examples 516P4AUDIT 517

P4AUTH 518

Usage Notes 518Value if not Explicitly Set 518Examples 518Notes 518

P4BROKEROPTIONS 519

P4CHANGE 520

P4CHARSET 521

P4_port_CHARSET 523

P4CLIENT 524

P4CLIENTPATH 525

P4COMMANDCHARSET 526

P4CONFIG 527

P4DEBUG 529

P4DESCRIPTION 530

P4DIFF 531

P4DIFFUNICODE 532

P4EDITOR 533

P4ENVIRO 534

P4HOST 536

P4IGNORE 537

P4JOURNAL 540

P4LANGUAGE 541

P4LOG 542

P4LOGINSSO 543

P4MERGE 545

P4MERGEUNICODE 547

P4NAME 548

P4PAGER 549

P4PASSWD 550

P4PCACHE 551

P4PFSIZE 552

9

P4POPTIONS 553

P4PORT 554

P4ROOT 557

P4SSLDIR 558

P4TARGET 560

P4TICKETS 561

P4TRUST 562

P4USER 563

PWD 564

TMP, TEMP 565

Global Options 566File Specifications 570Views 577Usage Notes 577

File Types 581Base filetypes 581

File typemodifiers 583

Perforce file types for common file extensions 585

Keyword Expansion 586

Usage Notes 586

Configurables 589Configurables that affect the server 589

Configurables that affect the client 589

Configurables that affect the proxy 590

Configurables - alphabetical list 590

Index 591A 594C 598D 598F 605J 609L 610M 613N 616

10

P 626R 627S 634T 644Z 645

Glossary 646License Statements 664

11

How to use this GuideThis reference includes every Helix Server command, environment variable, and configurable, andassumes knowledge of the concepts in Solutions Overview: Helix Version Control System.

FeedbackHow can we improve this manual? Email us at manual@perforce.com.

Other documentationSee https://www.perforce.com/support/self-service-resources/documentation.

Syntax conventionsHelix documentation uses the following syntax conventions to describe command line syntax.

Notation Meaningliteral Must be used in the command exactly as shown.

italics A parameter for which youmust supply specific information. For example, fora serverid parameter, supply the ID of the server.

[-f] The enclosed elements are optional. Omit the brackets when you composethe command.

... n Repeats as much as needed:l alias-name[[$(arg1)...[$(argn)]]=transformation

n Recursive for all directory levels:

l clone perforce:1666 //depot/main/p4...~/local-repos/main

l p4 repos -e //gra.../rep...

element1 |element2

Either element1 or element2 is required.

13

https://www.perforce.com/perforce/doc.current/manuals/overview/mailto:manual@perforce.comhttps://www.perforce.com/support/self-service-resources/documentation

Whats new in this guide

Whats new in this guideThis section provides a summary with links to topics in this reference. For a complete list of what's newin this release, see theRelease Notes.

2018.1 release

Area Feature

graph depot n For a graph depot, "p4 describe" on page124 can use the "classic" syntax,or using the SHA1, can provide a commit description. See thep4description "Examples" on page126.

n "p4 filelog" on page151

n "p4 fstat" on page166

n "p4 print" on page316

n "p4 revert" on page394

n "p4 show-permissions" on page428

n "p4 graph show-ref" on page176

n "p4 graph tags" on page175

n triggers related to graph depots: see theWhat's New in the HelixVersioning Engine Administrator Guide:Fundamentals.

n Support for Git Large File Storage (LFS).A replica can sync LFS files from graph depots.See the File Types chapter on "File typemodifiers" on page583,specifically the+Fmodifier.

14

http://www.perforce.com/perforce/doc.current/user/relnotes.txt

2018.1 release

"Configurables- alphabeticallist" onpage590

n "