Sanity Tests » no-illegal-filenames — Ansible Documentation

- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Documentation

# Sanity Tests » no-illegal-filenames

Files and directories should not contain illegal characters or names so that Ansible can be checked out on any Operating System.

## Illegal Characters

The following characters are not allowed to be used in any part of the file or directory name;

- `<`
- `>`
- `:`
- `"`
- `/`
- `\`
- `|`
- `?`
- `*`
- Any characters whose integer representations are in the range from 0 through to 31 like `\n`

The following characters are not allowed to be used as the last character of a file or directory;

- `.`
- `" "` (just the space character)

## Illegal Names

The following names are not allowed to be used as the name of a file or directory excluding the extension;

- `CON`
- `PRN`
- `AUX`
- `NUL`
- `COM1`
- `COM2`
- `COM3`
- `COM4`
- `COM5`
- `COM6`
- `COM7`
- `COM8`
- `COM9`
- `LPT1`
- `LPT2`
- `LPT3`
- `LPT4`
- `LPT5`
- `LPT6`
- `LPT7`
- `LPT8`
- `LPT9`

For example, the file `folder/COM1`, `folder/COM1.txt` are illegal but `folder/COM1-file` or `folder/COM1-file.txt` is allowed.