AccuRev® CLI User’s Guide Version 7.1 Revised 30-October-2017 Copyright and Trademarks Copyright © Micro Focus 2017. All rights reserved. This product incorporates technology that may be covered by one or more of the following patents: U.S. Patent Numbers: 7,437,722; 7,614,038; 8,341,590; 8,473,893; 8,548,967. AccuRev, AgileCycle, and TimeSafe are registered trademarks of Micro Focus. AccuBridge, AccuReplica, AccuSync, AccuWork, Kando, and StreamBrowser are trademarks of Micro Focus. All other trade names, trademarks, and service marks used in this document are the property of their respective owners. Table of Contents Preface........................................................................................................................vii Using This Book ................................................................................................................................ vii Typographical Conventions ............................................................................................................... vii Contacting Technical Support............................................................................................................ vii 1. Overview of the AccuRev® Command-Line Interface ........................................................................................ 1 Using AccuRev with a Secure AccuRev Server............................................................................ 1 Working with Files in a Workspace ..............................................................................................3 Working with Multiple Repositories .............................................................................................4 File Locking in Workspaces.......................................................................................................... 5 Selecting Elements Based on their Status.................................................................................... 10 Performance Considerations for Element-Selection Commands ................................................ 12 Selecting Elements Using Filename Patterns .............................................................................. 13 Combining File-Status Filters with Filename Patterns................................................................ 14 Selecting Elements Using Element-IDs ...................................................................................... 14 Creating a Workspace.................................................................................................................. 15 Placing Files Under Version Control........................................................................................... 17 Editing Files in a Workspace....................................................................................................... 17 Checkpointing — Saving Private Versions................................................................................. 17 Comparing Versions of a Text File ............................................................................................. 18 Making Your Changes Public...................................................................................................... 18 Concurrent Development — Working Well with Others............................................................ 19 Determining the Status of Files ................................................................................................... 19 Getting Element History.............................................................................................................. 20 Tracking Other Users’ Work ....................................................................................................... 20 Incorporating Other Users’ Work into Your Workspace ............................................................ 21 Concurrent Development — When Streams Collide .................................................................. 21 Managing a Depot’s Stream Hierarchy ....................................................................................... 22 Managing and Creating New Versions of Files........................................................................... 24 Getting Status Information .......................................................................................................... 26 Include/Exclude Rule Facility ..................................................................................................... 27 Administration............................................................................................................................. 27 Managing Users and Security...................................................................................................... 28 Managing Change Packages........................................................................................................ 29 2. AccuRev® Command-Line Reference ............................................................................................................... 31 Command Summary........................................................................................................................... 31 add...................................................................................................................................................... 36 addmember......................................................................................................................................... 40 anc ...................................................................................................................................................... 41 anchor................................................................................................................................................. 45 AccuRev® CLI User’s Guide iii annotate .............................................................................................................................................. 47 archive................................................................................................................................................ 49 authmethod......................................................................................................................................... 54 backup ................................................................................................................................................ 55 cat ....................................................................................................................................................... 56 chdepot ............................................................................................................................................... 58 chgroup............................................................................................................................................... 60 chmod................................................................................................................................................. 61 chpasswd ............................................................................................................................................ 62 chref.................................................................................................................................................... 63 chslice................................................................................................................................................. 65 chstream ............................................................................................................................................. 67 chuser ................................................................................................................................................. 69 chws.................................................................................................................................................... 71 clear.................................................................................................................................................... 73 co........................................................................................................................................................ 74 cpkadd ................................................................................................................................................ 76 cpkdepend .......................................................................................................................................... 78 cpkdescribe......................................................................................................................................... 82 cpkremove.......................................................................................................................................... 84 defunct................................................................................................................................................ 86 demote................................................................................................................................................ 90 diag..................................................................................................................................................... 94 diff...................................................................................................................................................... 95 disable_ssl