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.