P4VC command line client for P4V components
P4VC is a command-line client that can send certain P4 command-line commands to P4V without having to open a full P4V instance. For example, some users of the P4 command-line client might find P4VC to be a convenient way to view the Revision Graph, the Stream Graph, and create or update a review for Helix Swarm.
If P4V is not already running on your computer, your first P4VC command launches a P4V instance.
If P4V is already running, your P4VC commands apply to your P4V instance.
Command Syntax
Command-line help is available:
p4vc -h displays the list of options:
p4vc [options] command [arg ...] Options: -h -? print this message -V print client version -c client set client name (default $P4CLIENT) -C charset set character set (default $P4CHARSET) -p port set server port (default $P4PORT) -u user set user's username (default $P4USER)
p4vc -help displays the list of commands.
You will see more complete help when you invoke the help for a specific command, such as p4vc help branch
but what follows is a summary of the output of
p4vc help [command]
for each command.
Command |
Purpose |
Syntax |
---|---|---|
help | Print the requested help message. | p4vc [options] help |
shutdown |
Shut downs the p4v service.
|
p4vc [options] shutdown |
branch | Show or edit the branch. | p4vc [options] branches |
branches | Same as branchmappings. Show the list of branch mappings. | p4vc [options] branches |
branchmappings | Shows the list of branch mappings. | p4vc [options] branchmappings |
change | Show/Edit change. | p4vc [options] change [ spec, ... ] |
client | Same as workspace. Show/Edit workspace. | p4vc [options] client [ spec, ... ] |
clients | Same as workspaces. Show the list of workspaces. | p4vc [options] clients |
depot | Show/Edit depot. | p4vc [options] depot [ spec, ... ] |
diff |
Show the Diff Files dialog box. If you specify files, you can use depot paths, local paths, or a mix of depot and local paths. |
p4vc [options] diff [ file(s) ] |
diff -f |
Diff two valid file paths immediately, without first showing the Diff Files dialog box. You can specify depot paths, local paths, or a mix of depot and local paths. |
p4vc [options] diff -f filepath1 filepath2 |
diffhave |
Diff opened files against have revision (local paths). If you specify files, you can use depot paths, local paths, or a mix of depot and local paths. |
p4vc [options] diffhave [ file(s) ] |
diffprev |
Diff against a previous revision (depot path#revision). If you specify files, you can use depot paths, local paths, or a mix of depot and local paths. |
p4vc [options] diffprev [ file(s) ] |
group | Show/Edit group. | p4vc [options] group [ spec, ... ] |
groups | Show the list of groups. | p4vc [options] groups |
history | Shows file history. | p4vc [options] history [ file(s), ... ] |
job | Show/Edit job. | p4vc [options] job [ spec, ... ] |
jobs | Show the list of jobs. | p4vc [options] jobs |
label | Show/Edit label. | p4vc [options] label [ spec, ... ] |
labels | Show the list of labels. | p4vc [options] labels |
pendingchanges | Show the list of pending changes. | p4vc [options] pendingchanges |
properties | Shows file details. | p4vc [options] properties [ file(s), ... ] |
resolve | Launches resolve dialog box. | p4vc [options] resolve [ -f ] [ -c num ] [ file(s), ... ] |
revgraph | Same as revisiongraph. Shows the revision graph. | p4vc [options] revgraph [ file(s), ... ] |
reviewrequest | Launches the Request new Swarm Review dialog box. If you want to create a review request for the default changelist, use p4vc reviewrequest without providing a changelist number. |
p4vc [options] reviewrequest [ -c num ] |
reviewupdate | Launches the Update Review dialog box update an existing Swarm review. This can be to update a changelist that is already associated with a review in Helix Swarm as well as to add a pending or submitted changelist to an existing review. | p4vc [options] reviewupdate -c num |
revisiongraph | Show the revision graph. | p4vc [options] revisiongraph [ file(s), ... ] |
streamgraph | Show the stream graph pane. | p4vc [options] streamgraph [ file(s) ] |
streams | Shows the list of streams | p4vc [options] streams |
submit | Launch the submit dialog box. | p4vc [options] submit [ -c num ] [ file(s), ... ] |
submittedchanges | Show the list of submitted changes. | p4vc [options] submittedchanges |
timelapse | Show time-lapse view. See View file history with Time-lapse View. | p4vc [options] timelapse [-l linenumber] [ file(s), ... ] |
timelapseview | Same as timelapse. Show time-lapse view. | p4vc [options] timelapseview [ file(s), ... ] |
tlv | Same as timelapse. Show time-lapse view. | p4vc [options] tlv [ file(s), ... ] |
topology |
Graphically display the topology data in the specified |
p4vc [options] topology json-file |
user | Show/Edit user. | p4vc [options] user |
users | Show the list of users. | p4vc [options] users |
workspace | Show/Edit workspace. | p4vc [options] workspace [ spec, ... ] |
workspaces | Show the list of workspaces. | p4vc [options] workspaces |
workspacewindow |
Launches a WorkspaceWindow for the provided connection. If the window is already opened, it will be brought to the foreground, and the requested selection will be applied.
|
p4vc [options] workspacewindow [ -r ] [ -s path ] [ -t tab ] |
- Host = localhost Port = 7999
- The first command sent from P4VC launches a background process. If it fails, the connection timeout is 45 seconds
- Submit HTML Actions are available with P4VC. HTML Actions provide a way to customize behavior before or after a Submit action. To develop your own custom HTML Actions, see the Add custom HTML pages to P4V topic in the P4VJS Developer Guide.