Name

Protect

Synopsis

FILE/A,FLAGS,ADD/S,SUB/S,ALL/S,QUIET/S,GROUP/K,OTHER/K

Location

C:

Function

Add or remove protection bits from a file or directory.

Protect allows the use of pattern matching and recursive directory
scans to protect many files/directories at any one time.

Inputs

FILE   --  Either a file, a directory or a pattern to match.
FLAGS  --  One or more of the following flags:

            S - Script
            P - Pure
            A - Archive
            H - Hold
            R - Read
            W - Write
            E - Execute
            D - Delete

ADD    --  Allows the bits to be set and hence allowable.
SUB    --  Allows the bits to be cleared and hence not allowable.
ALL    --  Allows a recursive scan of the volume/directory.
QUIET  --  Suppresses progress output; errors are still reported.
GROUP  --  Group RWED permissions, available with security.library.
          Prefix + to add, - to remove; otherwise replace.
OTHER  --  Other-user RWED permissions, with the same syntax.

Result

Standard DOS return codes.

Example

Protect ram: e add all

    Recurses the ram: volume and attaches the executable bit.

Notes

Owner RWED bits are active low; group and other RWED bits
are active high. Without ADD or SUB, FLAGS replace the protection
word supplied to dos.library/SetProtection(). When FLAGS and
GROUP/OTHER are omitted, owner RWED is denied. With
security.library resident, DOS applies its normal
LIMITDOSSETPROTECTION policy to group/other rights.
Explicit GROUP/OTHER changes use secSetProtection().

See also

dos.library/SetProtection()