Last modified: $Date: 2006-11-25 10:18:46 +0900 (Sat, 25 Nov 2006) $
Edits the current policy in /proc/ccs/policy/ directory.
You may give one of "s" "e" "d" to the commandline to choose the initial screen. If not given, screen for domain listing is shown.
Keys applicable to all screens
q/Q | Quit |
r/R | Refresh |
Up-arrow | Scroll 1 line up. |
Down-arrow | Scroll 1 line down. |
PageUp | Scroll 1 page up. |
PageDown | Scroll 1 page down. |
Keys applicable to screen for system policy
a/A | Add an entry. |
d/D | Delete the selected entry. |
Tab | Switch to screen for exception policy. |
Keys applicable to screen for exception policy.
a/A | Add an entry. |
d/D | Delete the selected entry. |
Tab | Switch to screen for domain listing. |
Keys applicable to screen for domain listing.
a/A | Create a domain. |
d/D | Delete the selected domain and its descendants. |
Tab | Switch to screen for system policy. |
Enter | Switch to screen for editing ACLs for the selected domain. |
@ | New search |
Left-arrow | Search previous |
Right-arrow | Search next |
Keys applicable to screen for editing ACLs for the selected domain
Enter | Return to screen for domain listing. |
a/A | Add an access permission. |
d/D | Delete existing permission. |
This program keeps pathnames on dynamically allocated memory on the first appearance of the pathname and never frees that memory until termination. This is to reduce memory usage for keeping filenames.
The same mechanism is used by the TOMOYO Linux kernel. The memory allocated by the kernel for keeping pathnames and access permissions is never freed. Therefore, you can't run in "accept mode" forever, otherwise the system falls into out of memory. But actual amount of extra memory consumed by TOMOYO Linux kernel, though it depends on the number of domains and number of access permissions for domains, is less than 1 MB in most systems.
The memory for keeping access logs is allocated dynamically, and is freed as soon as the userland program reads the log. Also, there is a limitation for the maximum number of logs that the kernel can keep, therefore the system won't become out of memory even if the userland program doesn't read the logs.
Edits the policy in /etc/ccs/ directory.
The usage is the same as "editpolicy".
Reloads the on-disk policy onto memory.
There are the following commandline parameters.
Changes the current control level (i.e. writing to /proc/ccs/status ) and displays the new control level.
You can give the new control level from commandline parameter.
Assigns a profile to domains.
You can give the new profile number and domainnames from the commandline parameter. The list of domainnames that the profile number assigned to has changed is printed.
Lists the domainnames of currently running processes belong to and the profile numbers the domains currently assigned to.
This program shows the profile number, the name of process, PID, the domainname like "pstree" command.
Saves the on-memory policy onto disk.
There are the following commandline parameters.
Generates syaoran.conf, the configuration file for SYAORAN (the Tamper-Proof /dev filesystem). You can use SYAORAN filesystem if you want to run the system with read-only root fs or you want to prevent device files from tampering.
You can't create files that are not listed in the configuration file. If the system creates device files dynamically, attach all necessary devices before executing this program to ensure all device files are listed in the configuration file.
Reads from /proc/ccs/info/grant_log and /proc/ccs/info/reject_log and writes to the location given in the commandline parameters.
The first commandline parameter is the location of access granted log. The second one is the location of access rejected log. You may give /dev/null as the location. If you needn't to save access logs, you needn't to run this program.
This program runs as a daemon. You can start from /etc/rc.d/rc.local if you are using RedHat Linux. The number of logs that the kernel will keep is given using "MAX_GRANT_LOG=integer" and "MAX_REJECT_LOG=integer" lines in the profile.
Remove duplicated entry from logs written by "ccs-auditd".
Reads logs written by "ccs-auditd" from standard input and sorts by domains and removes duplicated entries and writes to standard output.
Reads domain policy from standard input and checks the existence of pathnames, and dumps the nonexistent pathnames.
The nonexistent pathnames are likely used as temporal pathnames. So find the naming rules from similar nonexistent pathnames and append the pattern to /etc/ccs/exception_policy.txt and /proc/ccs/policy/exception_policy .
You can pass the content of /etc/ccs/domain_policy.txt or /proc/ccs/policy/domain_policy using redirection or pipes to the standard input of this program.
Appends shared libraries to exception policy automatically using "allow_read" directive when the location of shared libraries in /etc/ld.so.cache has changed.
By running this program while updating packages, you can avoid errors "unable to start applications because shared libraries are unreadable" when the pathnames of shared libraries accessed by general programs has changed.
Detects policy violation and displays the access request. You can tell the system whether the access request should be granted (or granted and policy should be appended to grant the access request) or rejected after you validate the access request.
By running this program while updating packages, you can avoid errors due to insufficient permissions.
Never grant access requests unconditionally. The cause of policy violation is not always updating packages, but may by malicious requests by attackers. If you grant access requests caused by malicious requests by attackers, the system gets intruded.
To enable "delayed enforcing mode", you need to either set "ALLOW_ENFORCE_GRACE=1" in /proc/ccs/status using "setlevel" command or assign a profile whose ALLOW_ENFORCE_GRACE is set to 1 to domains using "setprofile" command.
Reads policy files from standard input and checks syntaxes.
Prints errors with line numbers if any.
Loads policy files from /etc/ccs/ directory and executes /sbin/init .
Run this program by giving "init=/.init" option to kernel commandline.
This is a "fgrep" for /proc/ccs/policy/domain_policy .
Reads domain policy from standard input and replaces pathnames with patterns if the pathname matches to patterns given at commandline and writes to standard output. Pathnames that contains execute permission and domainnames won't be patterned.
Generates templates for exception policy. You need to review the output because automatically generated exception policy may contain redundant or dangerous entries.
A tiny shell that has no built-in command such as "kill". You can use this program for login shell ( the shell specified in the /etc/passwd file). You won't need this program if you don't want to reinforce login authentications.
You should make your own programs for additional authentications. You shouldn't use the following example programs without modifications.
This program fails unless the correct password is typed with the correct time interval. Conventional authentication programs don't check the time interval of typing, but this program does to prevent password brute force attack.
This program fails unless the correct password is typed and this program was invoked within 10 seconds after the parent process was invoked. Conventional authentication programs don't check the time interval between the invocation time of parent process and the invocation time of child process, but this program does to prevent password brute force attack.
This program fails while the file /tmp/.lockme exists. This program prompts for password, but doesn't check for password. This program checks for the existence of the file /tmp/.lockme . This program prevents password brute force attack by keeping locked just before you run this program. This is a program for demonstration, and using a filename that are apparent to crackers. You must customize if you want to use.
This program generates tokens based on the system time. The authentication will succeed if the output of "gettoken" is passwd to the input of "checktoken". These are programs for demonstration, and the algorithm is too poor. You must customize if you want to use.
This program displays strings as a challenge data. The authentication will succeed if you input only numerical letters from the challenge data as a response data. This is a program for demonstration, and the algorithm is too poor. You must customize if you want to use.
This is a re-implementation of "honey". Create a script and specify this program as the interpreter for the script.
This program generates one time password and sends it to the user using "mail". The authentication will succeed if the user input the password sent by "mail". To use this program, some mail server application is needed.
This program is used by client side. This program explicitly binds to local port and connects to server so that the server side firewall (such as "iptables") can use packet filtering based on client side's port number.