Mirrors/inspec
2
0
Fork 0
mirror of https://github.com/inspec/inspec synced 2024-11-10 15:14:23 +00:00
Code Issues Projects Releases Packages Wiki Activity

Add cautionary note to include leading zero in file mode specifications (#2606)

Browse source 
Signed-off-by: Aleksey Tsalolikhin <aleksey@verticalsysadmin.com>
This commit is contained in:
Aleksey Tsalolikhin 2018-03-02 10:47:46 -08:00 committed by Jared Quick
parent a6852a6f5a
commit 50e952701d
1 changed files with 12 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
docs/resources/file.md.erb
View file

@ -90,6 +90,18 @@ The `mode` property tests if the mode assigned to the file matches the specified
its('mode') { should cmp '0644' }
InSpec [octal](https://en.wikipedia.org/wiki/Leading_zero#0_as_a_prefix) values begin the numeric mode specification with zero.
For example, write:
{ should cmp '0644' }
not
{ should cmp '644' }
Without the zero prefix for the octal value, the InSpec will interpret the it as the _decimal_ value 644, which is octal 1024 or `-----w-r-T`, and any test for a file that is `-rw-r--r--` will fail.
### mtime
The `mtime` property tests if the file modification time for the file matches the specified value. The mtime, where supported, is returned as the number of seconds since the epoch.