cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
ansible/docs/docsite/rst/dev_guide/testing/sanity/no-illegal-filenames.rst
Matt Clay b4494fa547 Remove redundant "Sanity Tests »" from page title. 
The docs now have multi-level breadcrumbs so including "Sanity Tests »" in the title on a sanity test page is redundant.
2019-07-26 09:07:42 -07:00

1.1 KiB
Raw Blame History

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.