CADO.CONF(5)

NAME
cado.conf - Capability Ambient DO: configuration file

DESCRIPTION
The /etc/cado.conf file is used to configure which ambient cabalities can be provided by cado to users. cado uses the capability cap_dac_read_search to access /etc/cado.conf, so this configuration does not need to be readable by users. All lines beginning with the sign '#' are comments. Non-comment lines have the following syntax
       list_of_capabilities: list_of_users_and_groups
or
       list_of_capabilities: list_of_users_and_groups: list_of_auth_commands
Both list_of_capabilities and list_of_users_and_groups are comma separated lists of identifiers. Items of list_of_capabilities are capability names or capability masks (exadecimal numbers). For brevity, the cap_ prefix of capability names can be omitted (e.g. net_admin and cap_net_admin have the same meaning). Items of list_of_users_and_groups are usernames or groupnames (groupnames must be prefexed by '@'). list_of_auth_commands is a command or a list of commands separated by semicolon (;). If present, cado runs all the sequence of commands it grants the capabilities as defined in the current line only if all return zero as their exit status. Example of cado.conf file:
	# Capability Ambient DO configuration file
	# cado.conf

	net_admin: @netadmin,renzo: /usr/bin/logger cado net_admin $USER; /bin/echo OK
	net_admin: @privatenet: /usr/local/lib/cado_autorize_privatenet
	net_admin,net_bind_service,net_raw,net_broadcast: @vxvdex
	cap_kill: renzo
In this example the renzo's processes can be granted (by cado) cap_net_admin and cap_kill. cap_net_admin can be acquired by processes owned by users belonging to the netadmin group. Users in vxvdex can provide their processes with a subset of cap_net_admin, cap_net_bind_service, cap_net_raw and cap_net_broadcast

SEE ALSO
cado(1), caprint(1), capabilities(7)