version 1.1, 2005/02/19 22:15:41 |
version 1.2, 2005/02/21 10:41:28 |
|
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
utility provides a simple method of querying a capability database such as |
utility provides a simple method for querying a capability database such as |
.Pa /etc/login.conf |
.Pa /etc/login.conf |
or |
or |
.Pa /etc/printcap |
.Pa /etc/printcap |
|
|
query instead. |
query instead. |
.It string |
.It string |
A string capability (key=value). |
A string capability (key=value). |
Note that the value printed has escape sequences expanded, see |
Note that the value printed has escape sequences expanded: see |
.Xr getcap 3 |
.Xr getcap 3 |
for a list of valid escape sequences. |
for a list of valid escape sequences. |
To print the string exactly as it is listed in the |
To print the string exactly as it is listed in the |
capabilities database, use a |
capabilities database, use a |
.Dq raw |
.Dq raw |
query instead. |
query instead. |
.It raw |
.It raw |
|
|
.El |
.El |
.Pp |
.Pp |
.Nm |
.Nm |
prints the value associated with the give key. |
prints the value associated with the given key. |
If more than one record is being searched, the value is prefixed |
If more than one record is being searched, the value is prefixed |
with the record name (for records with multiple names, only the |
with the record name (for records with multiple names, only the |
first is printed). |
first is printed). |
|
|
.It Fl c Ar capability |
.It Fl c Ar capability |
Return the raw value for the key |
Return the raw value for the key |
.Ar capability , |
.Ar capability , |
which must include the type as the last character, e.g. |
which must include the type as the last character, e.g.\& |
.Dq foo= |
.Dq foo= |
for the string |
for the string |
.Sq foo . |
.Sq foo . |
|
|
Only one of the |
Only one of the |
.Fl b , |
.Fl b , |
.Fl c , |
.Fl c , |
.Fl n |
.Fl n , |
and |
and |
.Fl s |
.Fl s |
options may be specified. |
options may be specified. |
If none are specified, the record will be dumped from the database as-is. |
If none are specified, the record will be dumped from the database as is. |
.Sh FILES |
.Sh FILES |
.Bl -tag -width /etc/login.conf -compact |
.Bl -tag -width "/etc/login.confXX" -compact |
.It Pa /etc/login.conf |
.It Pa /etc/login.conf |
login configuration |
login configuration |
.It Pa /etc/printcap |
.It Pa /etc/printcap |
|
|
.Pp |
.Pp |
Dump the |
Dump the |
.Dq default |
.Dq default |
record in |
record in |
.Xr login.conf 5 : |
.Xr login.conf 5 : |
.Pp |
.Pp |
.Dl "$ getcap -f /etc/login.conf default" |
.Dl "$ getcap -f /etc/login.conf default" |
.Pp |
.Pp |
Print all |
Print all |
.Xr login.conf 5 : |
.Xr login.conf 5 |
records with the |
records with the |
.Dq localcipher |
.Dq localcipher |
capability: |
capability: |
|
|
command appeared in |
command appeared in |
.Ox 3.7 . |
.Ox 3.7 . |
.Sh AUTHORS |
.Sh AUTHORS |
Todd C. Miller |
.An Todd C. Miller |