Skip to content

[BUG] Documentation is missing information on lack of support for symbolic file modes #64624

Open
@TimidRobot

Description

@TimidRobot

Description
The documentation is completely silent on the lack of symbolic file modes.

Steps to Reproduce the behavior

Expected behavior
For example:

  • salt/salt/states/file.py

    Lines 102 to 104 in b45c319

    When using a mode that includes a leading zero you must wrap the
    value in single quotes. If the value is not wrapped in quotes it
    will be read by YAML as an integer and evaluated as an octal.
  • Something like the following might be clearer:

    Symbolic file modes are not supported. When using an octal file mode that includes a leading zero, you must wrap the value in single quotes. If the value is not wrapped in quotes, it will be read by YAML as an integer and evaluated as an octal number instead of an octal file mode.

Additional context
Related:

Metadata

Metadata

Assignees

No one assigned

    Labels

    DocumentationRelates to Salt documentationgood first issuegood for someone new to salthelp-wantedCommunity help is needed to resolve thisseverity-medium3rd level, incorrect or bad functionality, confusing and lacks a work aroundtime-estimate-single-day

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions