KAF(5,F) AIX Technical Reference KAF(5,F)
-------------------------------------------------------------------------------
kaf
PURPOSE
Specifies how to process ddi keywords and their parameters.
DESCRIPTION
Keyword Attribute Files, also called kaf files, define how the devices command
and customize helpers are to process keywords used in ddi files. The kaf
files:
o Contain instructions for processing device information
o Control whether the devices command displays the associated information
o Control whether a user can change the information using the devices command
o Specify the input validation that the devices command performs
o Determine the action that the customize helper takes.
The kaf information can be included in the ddi file for the device, or it can
appear in a separate file. If it is contained in a separate file, then the
stanza for the device in the system file must name the kaf file as the value of
the kaf_file keyword. The kaf_use keyword (also in the system file) specifies
the stanza of the kaf file to use.
The name of each stanza in a kaf file is the name of a keyword that is used in
ddi files. The stanza defines how the devices command and customize helper
programs process that ddi keyword. The following section defines the keywords
that can appear in the stanzas of kaf files.
The use of extended characters in kaf files is not supported.
Devices that can be added, deleted, or changed by devices must have a kaf file.
Control over Display and Modification of the Keyword
display If set to TRUE, then the devices command displays the device
characteristic keyword and allows the user to change its value.
User Input Validation
vtype Specifies the type of checking that the devices command performs on
values entered by the user. vtype can be set to one of the following
values:
0 No validation.
1 Mapping validation: The input value must be one of the keywords
found in the stanza named by the map keyword.
Processed November 7, 1990 KAF(5,F) 1
KAF(5,F) AIX Technical Reference KAF(5,F)
3 Range validation: The input value must have the data type
specified by the type keyword and must fall in the range specified
by the range keyword.
map Names a stanza in the kaf file that contains a list of keyword=value
pairs against which the input value is to be matched. If the input
matches a given keyword, then the corresponding value is substituted
in its place.
opts Specifies the options to search for in the /etc/ddi/options file.
opts is one of the following:
k Keyword only
c Keyword followed by device class
t Keyword followed by device type
s Keyword followed by device stanza name.
If the opts keyword is not specified, its value defaults to k. See
"options" for details about the /etc/ddi/options file.
range Defines the valid range of values for a keyword so that the devices
command can verify values entered by the user. The value of the range
keyword has the format first,last,incr, where first is the first
number in the range, last is the last number, and incr is the
increment between values in the range. For example, "range=2,10,2"
specifies the values 2, 4, 6, 8, and 10.
type Defines the data type for the value of a keyword. The devices command
ensures that the values entered are the correct data type, specified
by one of the following:
F Floating-point (float)
H Hexadecimal (int)
I Integer (int)
L Long integer (long int)
S Short integer (short int)
U Unsigned integer (unsigned int).
FILES
/etc/ddi/opprinter.kf
/etc/ddi/osprinter.kf
/etc/ddi/plotter.kaf
/etc/ddi/pprinter.kaf
/etc/ddi/sprinter.kaf
/etc/ddi/tty.kaf
/etc/mdkaf
/etc/ddi/c327
/etc/ddi/nty.kaf
/etc/ddi/pty
Processed November 7, 1990 KAF(5,F) 2
KAF(5,F) AIX Technical Reference KAF(5,F)
RELATED INFORMATION
In this book: "attributes," "ddi," "descriptions," and "system."
Processed November 7, 1990 KAF(5,F) 3