Clarify usage of file.attributes

[simplepad]

What is the expected format for the value of file.attributes? The description states: "The bitmask value that represents the file attributes". For a UNIX system, is it expected that the attributes like "0777" are transformed into an integer like 777 (base 8), or 511 (base 10)? It would be very helpful if the field description provided some examples, as it is not a simple string_t field.

[jedwardsol]

As well as "attributes" which here is assumed to be Unix file permissions (RWX for user, group, world)

Windows has file attributes too, which have different meaning and numeric values (https://learn.microsoft.com/en-us/windows/win32/fileio/file-attribute-constants)

There are also other fields in the file object which overlap with this and each other

• some is_Xxx fields (e.g. is_readonly)
• security_descriptor A Windows security descriptor plays the role of the Unix attributes - specifying permissions vs. user mappings. There are different ways of representing a Windows security descriptor textually, so the description on this field is ambiguous too.