Table 1 Contents of the FIB
Field |
Meaning |
FIB$L_ACCTL
|
Contains flag bits that
control the access to the file. Sections
Input Parameters,
Input Parameters,
Input Parameters, and
Input Parameters, and
Delete File describe the FIB$L_ACCTL field flag bits.
|
FIB$L_ACL_STATUS
|
Status of the requested
ACL attribute operation, if any. The ACL attributes are included
in
ACP-QIO Attributes. If no ACL attributes
are given, SS$_NORMAL is returned here.
|
FIB$L_ACLCTX
|
Maintains position context
when processing ACL attributes from the attribute (P5) list.
|
FIB$B_ALALIGN
|
Contains the interpretation
mode of the allocation (FIB$W_ALLOC) field.
|
FIB$W_ALLOC
|
Contains the desired physical
location of the blocks being allocated. Interpretation of the field
is controlled by the FIB$B_ALALIGN field. The following subfields
are defined:
|
|
Subfield
|
Meaning
|
|
FIB$W_LOC_FID
|
Three-word related file ID for RFI placement.
|
|
FIB$W_LOC_NUM
|
Related file number.
|
|
FIB$W_LOC_SEQ
|
Related file sequence number.
|
|
FIB$B_LOC_RVN
|
Related file relative volume number (RVN)
or placement RVN.
|
|
FIB$B_LOC_NMX
|
Related file number extension.
|
|
FIB$L_LOC_ADDR
|
Placement logical block number (LBN), cylinder,
or virtual block number (VBN).
|
|
FIB$B_ALOPTS
|
Contains option bits that control the placement
of allocated blocks.
Input Parameters describes
the FIB$B_ALOPTS field flag bits.
|
FIB$L_ALT_ACCESS
|
A 32-bit mask that represents
an access mask to check against file protection; for example, opens
a file for read access and checks whether it can be deleted. The
mask has the same configuration as the standard protection mask.
|
FIB$W_CNTRLFUNC
|
In an IO$_ACPCONTROL function,
this field contains the code that specifies which ACP control function
is to be performed (see
ACP Control). This field overlays FIB$W_EXCTL.
|
FIB$L_CNTRLVAL
|
Contains a control function
value used in an IO$_ACPCONTROL function (see
ACP Control). The interpretation of the value depends
on the control function specified in FIB$W_CNTRLFUNC. This field
overlays FIB$L_EXSZ.
|
FIB$W_DID
|
Contains the file identifier
of the directory file.
For Files-11 On-Disk Structure
Level 1 and Level 2, the following subfields are defined:
|
|
Subfield
|
Meaning
|
|
FIB$W_DID_NUM
|
File number.
|
|
FIB$W_DID_SEQ
|
File sequence number.
|
|
FIB$W_DID_RVN
|
Relative volume number (only for magnetic
tape devices).
|
|
FIB$B_DID_RVN
|
Relative volume number (only for disk devices).
|
|
FIB$B_DID_NMX
|
File number extension (only for disk devices).
|
FIB$W_EXCTL
|
Contains flag bits that
specify extend control for disk devices. Sections
Input Parameters and
Input Parameters describe the FIB$W_EXCTL field flag bits.
|
FIB$L_EXSZ
|
Specifies the number of
blocks to be allocated in an extend operation on a disk file.
|
FIB$L_EXVBN
|
Specifies the starting disk
file virtual block number at which a file is to be truncated.
|
FIB$W_FID
|
Specifies the file identification.
You supply the file identifier when it is known; the ACP returns
the file identifier when it becomes known; for example, as a result
of a create or directory lookup. A 0 file identifier can be specified
when an operation is performed on a file that is already open on
a particular channel. The ACP returns the file identifier of the open
file.
For Files-11 On-Disk Structure Level 1 and Level
2, the following subfields are defined:
|
|
Subfields
|
Meaning
|
|
FIB$W_FID_NUM
|
File number.
|
|
FIB$W_FID_SEQ
|
File sequence number.
|
|
FIB$W_FID_RVN
|
Relative volume number (only for magnetic
tape devices).
|
|
FIB$B_FID_RVN
|
Relative volume number (only for disk devices).
|
|
FIB$B_FID_NMX
|
File number extension (only for disk devices).
|
|
FIB$W_FID_DIRNUM
|
Directory number of the file identifier. This
is the path table record number of the directory that describes
the file.
|
|
FIB$L_FID_RECNUM
|
Record number of the first directory record
for the file within the current directory.
|
FIB$B_NAME_FORMAT_IN
|
Contains the format of the
input file specification.
Input Parameters describes
the FIB$B_NAME_FORMAT_IN field flag bits.
|
FIB$B_NAME_FORMAT_OUT
|
Contains the format of the
output file specification.
Input Parameters describes
the FIB$B_NAME_FORMAT_OUT field flag bits.
|
FIB$W_NMCTL
|
Contains flag bits that
control the processing of a name string in a directory operation.
Sections
Input Parameters and
Input Parameters describe the FIB$W_NMCTL field
flag bits.
|
FIB$L_STATUS
|
Access status. Applies to
all major functions. The following bits are supported:
|
|
Subfields
|
Meaning
|
|
FIB$V_ALT_REQ
|
Set to indicate whether the alternate access
bit is required for the current operation. If not set, the alternate
access bit is optional.
|
|
FIB$V_ALT_GRANTED
|
If FIB$V_ALT_REQ = 0, the FIB bit returned
from the file system is set if the alternate access check succeeded.
Programmers
can control the security information being propagated as well as the
source of this information by setting the following bits (which
apply only to the IO$_CREATE and IO$_MODIFY functions).
|
|
FIB$V_DIRACL
|
Propagate the ACL from the parent directory
to the file, assuming the file is a directory file.
|
|
FIB$V_EXCLPREVIOUS
|
Set to indicate that propagation may
not occur from a previous version of the file.
|
|
FIB$V_ALIAS_ENTRY
|
Set on any file system operation where the
directory backlink in the file header is different (and nonzero)
from the directory id specified in the FIB.
|
|
FIB$V_NOCOPYACL
|
Set to indicate that the ACL should not
be propagated from the parent directory (or a previous version of
the file) to the file.
|
|
FIB$V_NOCOPYOWNER
|
Set to indicate that the owner UIC should not
be propagated from the parent directory (or a previous version of
the file) to the file.
|
|
FIB$V_NOCOPYPROT
|
Set to indicate that the UIC-based protection
should not be propagated from the parent directory (or a previous
version of the file) to the file.
|
|
FIB$V_PROPAGATE
|
Propagate attributes from the parent directory
(or previous version of the file). If you set the FIB$V_NOCOPYACL, FIB$V_NOCOPYOWNER,
or FIB$V_NOCOPYPROT bits, you must also set FIB$V_PROPAGATE or a SS$_BADPARAM
error results.
|
FIB$W_VERLIMIT
|
Contains the version limit
of the directory entry.
|
FIB$L_WCC
|
Maintains position context
when processing wildcard directory operations.
|
FIB$B_WSIZE
|
Controls the size of the
file window used to map a disk file. If a window size of 255 is
specified, the file is completely mapped by using segmented windows.
|