Open files in a client workspace for addition to the depot.
p4 [g-opts] add [-c changelist] [-d -f -I -n] [-t filetype] file ...
p4 add opens files within the client workspace for
addition to the depot. The specified files are linked to a changelist.
The command can
add files to a new, empty depot or to a depot that already contains files. The files are added to the depot when the changelist is
submit. The added files must either not already
exist in the depot, or be marked as deleted at the
p4 add * is equivalent to
p4 reconcile -a
To open a file with
p4 add, the file must exist in
your client view, but does not need to exist in your workspace at the
p4 add. The file must exist in your
workspace when you run
submit. If not, the submission fails.
add does not create or overwrite files in your workspace.
If a file does not exist, you must create it yourself.
By default, the specified files are opened in the default changelist. To
open the files in a specified changelist, use the
To move files from the default changelist to a numbered changelist, use
When adding files,
the command first examines the typemap table (
typemap) to see if the system administrator has
defined a file type for the files being added. If a match is found, the
file’s type is set as defined in the typemap table. If a match is
the command examines the first bytes of the file based on the
filesys.binaryscan configurable (by default, 65536 bytes) to
determine whether it is
binary, and the
files are stored in the depot accordingly. By default, text file
revisions are stored in reverse delta format. Newly-added text files
larger than the limit imposed by the filetype.maxtextsize
configurable (by default, 10 MB) are assigned filetype
text+C and stored in full. Files compressed in the
.zip format (including
.jar files) are also
automatically detected and assigned the type
binary revisions are stored in full, with compression.
-t filetype option explicitly specifies a file
type, overriding both the typemap table and
default file type detection mechanism.
To add files containing the characters
%, use the
-f option. This
option forces literal interpretation of characters otherwise used by Helix Server as wildcards.
If you open a file for edit or move/add, and another user subsequently
deletes the file you opened, the operation will fail with an error when
you submit the changelist. To ensure that you create the desired target
file, specify the
-d option ("downgrade"). More
- You open a file for edit, then another user submits a changelist that
deletes or moves the file. When you submit your edits,
returns an error and the file remains open for edit. To restore the
file (including any changes you have made) to the depot location from
which you checked it out, open the file for add and specify the
-doption, then submit the file.
- You open a file for move/add and another user submits a changelist
that deletes the source file. When you submit the move,
returns an error and the file remains open for add/move. To create the
desired target file, issue the
p4 add -dcommand, specifying the target file, and submit the file.
Opens the files for
Downgrade file open status to simple add.
Do not perform any ignore checking; ignore any settings
Preview which files would be opened for add, without actually changing any files or metadata.
Adds the file as the specified filetype, overriding any settings in the typemap table.
See File types for a list of Helix Server file types.
See Global options.
|Can File Arguments Use Revision Specifier?
|Can File Arguments Use Revision Range?
|Minimal Access Level Required
- The local operating system expands the * wildcard (see Wildcards)
in file specifications provided to
Do not use ASCII expansions of special characters with
p4 add -f. To add the file
[email protected], use:
p4 add -f [email protected]
If you manually expand the
@sign and attempt to add the file
status%40june.txt, Helix Server interprets the
%sign literally, expands it to the hex code
%25, resulting in the filename
Assigns a specific file type to a new file, overriding any settings in the typemap table.
|p4 add -t text+D fileA.txt
|Stores the specified file in RCS format, which is uncompressed and, for this file, overrides the default setting of the lbr.autocompress configurable.
Opens all the files within the user’s current directory for
Opens a file named
To refer to this file in views, or with other
commands, you must subsequently use the hex expansion
For more information, see Limitations on characters in filenames and entities.
To open a file for edit, including to override its file type
To open a file for deletion
To move (rename) a file
To copy all open files to the depot
To read files from the depot into the client workspace
To create or edit a new changelist
To change default behavior of text and binary file detection
To list all opened files
To revert a file to its unopened state
To move an open file to a different pending changelist
To change an open file’s file type