## <summary>SELinux utility to run a shell with a new role</summary>

#######################################
## <summary>
##	The per role template for the userhelper module.
## </summary>
## <desc>
##	<p>
##	This template creates a derived domains which are used
##	for userhelper.
##	</p>
##	<p>
##	This template is invoked automatically for each user, and
##	generally does not need to be invoked directly
##	by policy writers.
##	</p>
## </desc>
## <param name="userdomain_prefix">
##	<summary>
##	The prefix of the user domain (e.g., user
##	is the prefix for user_t).
##	</summary>
## </param>
## <param name="user_domain">
##	<summary>
##	The type of the user domain.
##	</summary>
## </param>
## <param name="user_role">
##	<summary>
##	The role associated with the user domain.
##	</summary>
## </param>
#
template(`userhelper_per_role_template',`
	gen_require(`
		type userhelper_exec_t, userhelper_conf_t;
	')

	########################################
	#
	# Declarations
	#

	type $1_userhelper_t;
	application_domain($1_userhelper_t,userhelper_exec_t)
	domain_role_change_exemption($1_userhelper_t)
	domain_obj_id_change_exemption($1_userhelper_t)
	domain_interactive_fd($1_userhelper_t)
	domain_subj_id_change_exemption($1_userhelper_t)
	role $3 types $1_userhelper_t;
	
	########################################
	#
	# Local policy
	#
	allow $1_userhelper_t self:capability { setuid setgid net_bind_service dac_override chown sys_tty_config };
	allow $1_userhelper_t self:process ~{ ptrace setcurrent setexec setfscreate setrlimit execmem execstack execheap };
	allow $1_userhelper_t self:process setexec;
	allow $1_userhelper_t self:fd use;
	allow $1_userhelper_t self:fifo_file rw_fifo_file_perms;
	allow $1_userhelper_t self:shm create_shm_perms;
	allow $1_userhelper_t self:sem create_sem_perms;
	allow $1_userhelper_t self:msgq create_msgq_perms;
	allow $1_userhelper_t self:msg { send receive };
	allow $1_userhelper_t self:unix_dgram_socket create_socket_perms;
	allow $1_userhelper_t self:unix_stream_socket create_stream_socket_perms;
	allow $1_userhelper_t self:unix_dgram_socket sendto;
	allow $1_userhelper_t self:unix_stream_socket connectto;
	allow $1_userhelper_t self:sock_file read_sock_file_perms;

	#Transition to the derived domain.
	domtrans_pattern($2,userhelper_exec_t,$1_userhelper_t)

	allow $1_userhelper_t userhelper_conf_t:dir rw_dir_perms;
	rw_files_pattern($1_userhelper_t,userhelper_conf_t,userhelper_conf_t)

	can_exec($1_userhelper_t, userhelper_exec_t)

	dontaudit $2 $1_userhelper_t:process signal;
	
	kernel_read_all_sysctls($1_userhelper_t)
	kernel_getattr_debugfs($1_userhelper_t)
	kernel_read_system_state($1_userhelper_t)

	# Execute shells
	corecmd_exec_shell($1_userhelper_t)
	# By default, revert to the calling domain when a program is executed
	corecmd_bin_domtrans($1_userhelper_t,$2)

	# Inherit descriptors from the current session.
	domain_use_interactive_fds($1_userhelper_t)
	# for when the user types "exec userhelper" at the command line
	domain_sigchld_interactive_fds($1_userhelper_t)

	dev_read_urand($1_userhelper_t)
	# Read /dev directories and any symbolic links.
	dev_list_all_dev_nodes($1_userhelper_t)

	files_list_var_lib($1_userhelper_t)
	# Write to utmp.
	files_pid_filetrans($1_userhelper_t,initrc_var_run_t,file)
	# Read the /etc/security/default_type file
	files_read_etc_files($1_userhelper_t)
	# Read /var.
	files_read_var_files($1_userhelper_t)
	files_read_var_symlinks($1_userhelper_t)
	# for some PAM modules and for cwd
	files_search_home($1_userhelper_t)

	fs_search_auto_mountpoints($1_userhelper_t)
	fs_read_nfs_files($1_userhelper_t)
	fs_read_nfs_symlinks($1_userhelper_t)

	# Allow $1_userhelper to obtain contexts to relabel TTYs
	selinux_get_fs_mount($1_userhelper_t)
	selinux_validate_context($1_userhelper_t)
	selinux_compute_access_vector($1_userhelper_t)
	selinux_compute_create_context($1_userhelper_t)
	selinux_compute_relabel_context($1_userhelper_t)
	selinux_compute_user_contexts($1_userhelper_t)

	# Read the devpts root directory.
	term_list_ptys($1_userhelper_t)
	# Relabel terminals.
	term_relabel_all_user_ttys($1_userhelper_t)
	term_relabel_all_user_ptys($1_userhelper_t)
	# Access terminals.
	term_use_all_user_ttys($1_userhelper_t)
	term_use_all_user_ptys($1_userhelper_t)

	auth_domtrans_chk_passwd($1_userhelper_t)
	auth_manage_pam_pid($1_userhelper_t)
	auth_manage_var_auth($1_userhelper_t)
	auth_search_pam_console_data($1_userhelper_t)

	# Inherit descriptors from the current session.
	init_use_fds($1_userhelper_t)
	# Write to utmp.
	init_manage_utmp($1_userhelper_t)

	libs_use_ld_so($1_userhelper_t)
	libs_use_shared_libs($1_userhelper_t)

	miscfiles_read_localization($1_userhelper_t)

	seutil_read_config($1_userhelper_t)
	seutil_read_default_contexts($1_userhelper_t)

	userdom_use_unpriv_users_fds($1_userhelper_t)
	# Allow $1_userhelper_t to transition to user domains.
	userdom_bin_spec_domtrans_unpriv_users($1_userhelper_t)
	userdom_entry_spec_domtrans_unpriv_users($1_userhelper_t)

	ifdef(`distro_redhat',`
		optional_policy(`
			# Allow transitioning to rpm_t, for up2date
			rpm_domtrans($1_userhelper_t)
		')
	')

	tunable_policy(`! secure_mode',`
		#if we are not in secure mode then we can transition to sysadm_t
		userdom_bin_spec_domtrans_sysadm($1_userhelper_t)
		userdom_entry_spec_domtrans_sysadm($1_userhelper_t)
	')
	
	optional_policy(`
		ethereal_domtrans_user_ethereal($1,$1_userhelper_t)
	')

	optional_policy(`
		logging_send_syslog_msg($1_userhelper_t)
	')

	optional_policy(`
		nis_use_ypbind($1_userhelper_t)
	')

	optional_policy(`
		nscd_socket_use($1_userhelper_t)
	')

	ifdef(`TODO',`
		allow $1_userhelper_t xdm_t:fd use;
		allow $1_userhelper_t xdm_var_run_t:dir search;
		allow $1_userhelper_t xdm_t:fifo_file { getattr read write ioctl };

		optional_policy(`
			allow $1_userhelper_t gphdomain:fd use;
		')
		optional_policy(`
			domtrans_pattern($1_userhelper_t, xauth_exec_t, $1_xauth_t)
			allow $1_userhelper_t $1_xauth_home_t:file { getattr read };
		')
		optional_policy(`
			domtrans_pattern($1_mozilla_t, userhelper_exec_t, $1_userhelper_t)
		')
		# for when the network connection is killed
		dontaudit unpriv_userdomain $1_userhelper_t:process signal;
	')
')

########################################
## <summary>
##	Search the userhelper configuration directory.
## </summary>
## <param name="domain">
##	<summary>
##      Domain allowed access.
##	</summary>
## </param>
#
interface(`userhelper_search_config',`
	gen_require(`
		type userhelper_conf_t;
	')

	allow $1 userhelper_conf_t:dir search_dir_perms;
')

########################################
## <summary>
##	Do not audit attempts to search 
##	the userhelper configuration directory.
## </summary>
## <param name="domain">
##	<summary>
##      Domain to not audit.
##	</summary>
## </param>
#
interface(`userhelper_dontaudit_search_config',`
	gen_require(`
		type userhelper_conf_t;
	')

	dontaudit $1 userhelper_conf_t:dir search_dir_perms;
')

########################################
## <summary>
##	Allow domain to use userhelper file descriptor.
## </summary>
## <param name="prefix">
##	<summary>
##	The prefix of the domain, example user is the prefix of user_t.
##	</summary>
## </param>
## <param name="domain">
##	<summary>
##      Domain allowed access.
##	</summary>
## </param>
#
template(`userhelper_use_user_fd',`
	gen_require(`
		type $1_userhelper_t;
	')

	allow $2 $1_userhelper_t:fd use;
')

########################################
## <summary>
##	Allow domain to send sigchld to userhelper.
## </summary>
## <param name="prefix">
##	<summary>
##	The prefix of the domain, example user is the prefix of user_t.
##	</summary>
## </param>
## <param name="domain">
##	<summary>
##      Domain allowed access.
##	</summary>
## </param>
#
template(`userhelper_sigchld_user',`
	gen_require(`
		type $1_userhelper_t;
	')

	allow $2 $1_userhelper_t:process sigchld;
')

########################################
## <summary>
##	Execute the userhelper program in the caller domain.
## </summary>
## <param name="domain">
##	<summary>
##	The type of the process performing this action.
##	</summary>
## </param>
#
interface(`userhelper_exec',`
	gen_require(`
		type userhelper_exec_t;
	')

	can_exec($1,userhelper_exec_t)
')