File Syntax
Basics
The authz and groups files are plain text files. The file is split into a number of sections with zero or more entries:
# Comment ... [section] key.1 = value key.2 = multi-line value
Empty lines and lines that start with a ‘#
’ in the first column are ignored.
A section starts with a left bracket ‘[
’ in the first column and everything until the last right bracket ‘]
’ in the line is the section name.
Entries are pairs of keys and values. The key must start in the first column of the line and must not contain spaces or the ‘=
’ sign. The entry's value is everything from ‘=
’ to the end of the line; spaces are removed from the start and end of the value. Values can be continued on the next line by indenting that line by one or more spaces. In multi-line values, all spaces from the end of the previous line to the first non-space character in the continuation line are compressed to a single space. In the example above, the value for key.1
is “value
” and the value for key.2
is “multi-line value
”; note the single space. Comments and empty lines are forbidden in multi-line values.
Groups
Aliases
Rules
HowTo
Validating In-Repository Authz Files
References
- From The Book (Version Control with Subversion): Path-Based Authorization
- Does not cover new features and restrictions in version 1.10 and later.
- Release notes:
- Design documents:
- In-Repo Authz (1.8 and later)
- Authz Improvements (1.10 and later)
- Mailing list discussions:
- Related issues: