Helix Core is now P4. Product user interfaces will be updated soon. Learn more >>

P4 CLI Documentation | 2025.1

# Restrictions on filenames and identifiers

## Spaces in filenames, pathnames, and identifiers

Use quotation marks to enclose files or directories that contain spaces. For example:

`"//Acme/dev/docs/manuals/recommended configuration.doc"`

If you specify spaces in names for other P4 Server objects, such as branch names, client names, label names, and so on, the spaces are automatically converted to underscores by the P4 Server.

## Length limitations

Names assigned to P4 Server objects such as branches, client workspaces, and so on, cannot exceed 1,024 characters.

## Reserved characters

By default, the following reserved characters are not allowed in P4 Server identifiers or names of files managed by P4 Server:

Reserved Character | Reason
--- | ---
`@` | File revision specifier for date, label name, or changelist number
`#` | File revision numbers
`*` | Wildcard
`...` | Wildcard (recursive)
`%%1 - %%9` | Wildcard (see Rearrange parts of filenames with positional specifiers)
`/` | Separator for pathname components

These characters have conflicting and secondary uses. Conflicts include the following:

- UNIX separates path components with `/`, but many DOS commands interpret `/` as a command-line switch.
- Most UNIX shells interpret `#` as the beginning of a comment.
- Both DOS and UNIX shells automatically expand `*` to match multiple files, and the DOS command line uses `%` to refer to variables.

To specify these characters in filenames or paths, use the ASCII expression of the character’s hexadecimal value, as shown in the following table:

Character | ASCII
--- | ---
`@` | `%40`
`#` | `%23`
`*` | `%2A`
`%` | `%25`

Specify the filename literally when you add it; then use the ASCII expansion to refer to it thereafter. For example, to add a file called `recommended@configuration.doc`, issue the following command:

    p4 add -f //Acme/dev/docs/manuals/recommended@configuration.doc

When you submit the changelist, the characters are automatically expanded and appear in the change submission form as follows:

`//Acme/dev/docs/manuals/recommended%40configuration.doc`

After you submit the changelist with the file’s addition, you must use the ASCII expansion to sync the file to your workspace or to edit it within your workspace. For example:

    p4 sync //Acme/dev/docs/manuals/recommended%40configuration.doc

The requirement to escape the special characters `@`, `#`, `*`, or `%` also applies if you attempt to use them in the `Root:` or `AltRoots` fields of your client specification; escape them with `%40`, `%23`, `%2A`, or `%25` respectively.

## Filenames containing extended (non-ASCII) characters

Non-ASCII characters are allowed in filenames and P4 Server identifiers, but entering them from the command line might require platform-specific solutions. If you are using P4 Server in Unicode mode, all users must have `P4CHARSET` set properly. For details about setting `P4CHARSET`, see the P4 CLI Reference and the Internationalization Notes.

In international environments, use a common code page or locale setting to ensure that all filenames are displayed consistently across all computers in your organization. To set the code page or locale:

- Windows: use the Regional Settings applet in the Control Panel
- UNIX: set the `LOCALE` environment variable

Your search for returned results