p4 ignores

Displays the ignore mappings computed from the rules in P4IGNORE files.

Syntax

p4 [g-opts] ignores [-v] [path ...]
p4 [g-opts] ignores -i [-v] path ...

Syntax conventions

Description

It’s not always easy to tell why a file is being ignored during add (p4 add) and reconcile (p4 reconcile) operations. To help with that, p4 ignores lets you see the mappings in Perforce syntax that are applied for any specified path.

If you do not specify a path, the mappings for the current working directory are displayed.

Using the -v option outputs the rule that generated mappings and the line number in the file where the rule is defined. See Examples.

The -i option checks whether a filepath would be ignored. If so, the path is returned. With the -v option, a more verbose message is returned explaining whether the filepath would be ignored and if it matched any ignore rules.

Default ignored paths

The P4 and P4V clients by default ignore the following paths to allow better co-existence with the DVCS personal server functionality:

.../.p4root/...
.../.p4root

If the P4CONFIG variable is in use, the following path is also included:

.../.p4config

Options

`-i`	Test to see if the specified filepath would be ignored.
`-v`	Report additional information about the `P4IGNORE` rules in effect. When listing mappings, include the rules from which they were generated. When testing a filepath, include the rule that affected the output.
`path`	The path to be tested. Specify the path using local syntax.
`g-opts`	See Global options.

Usage notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
No	No	`none`

Examples

Note that in the following table, the commands in the left-hand column were run in the c:\workspace directory.

`p4 ignores`	Display a list of mappings generated from `P4IGNORE` rules. .../.p4root/... .../.p4root .../.p4config/... .../.p4config c:/workspace/.../builds/... c:/workspace/builds/... c:/workspace/.../builds c:/workspace/builds
`p4 ignores -v`	Display a list of mappings generated from `P4IGNORE` rules, including the rules that were generated from a `.p4ignore` file. #FILE - defaults #LINE 2:/.p4root .../.p4root/... .../.p4root #LINE 1:/.p4config .../.p4config/... .../.p4config #FILE c:\workspace\.p4ignore #LINE 1:builds c:/workspace/.../builds/... c:/workspace/builds/... c:/workspace/.../builds c:/workspace/builds If the p4 client is on Windows, the name of the rules file might be `p4ignore.txt`, and the output could be similar to this: #FILE - defaults #LINE 1:*/.p4root .../.p4root/... .../.p4root #FILE c:\workspace\p4ignore.txt #LINE 2:.html c:/workspace/....html/... c:/workspace/....html/
`p4 ignores -i file1 builds/file2`	Test to see whether `file1` and `file2` will be ignored. If a file is ignored, it will be returned. Otherwise, there will be no output. c:\workspace\builds\file2 ignored
`p4 ignores -i -v file1 builds/file2`	Test to see whether `file1` and `file2` will be ignored. If a file is ignored then it will be returned with information about the `P4IGNORE` rule that it matched. If it is not, it will be returned with a message saying that it is not ignored. If it matched a `P4IGNORE` exclusionary rule, information about that rule will also be returned. c:\workspace\file1 not ignored c:\workspace\builds\file2 ignored by c:\workspace\.p4ignore:1:builds