blob: 200a2d37cbc8970e08ac3f2c2323ba066c4f3bdb [file] [log] [blame]
Tetsuo Handa17a7b7b2009-04-13 11:04:19 +09001--- What is TOMOYO? ---
2
3TOMOYO is a name-based MAC extension (LSM module) for the Linux kernel.
4
5LiveCD-based tutorials are available at
Tetsuo Handae6f6a4c2010-07-27 17:17:06 +09006http://tomoyo.sourceforge.jp/1.7/1st-step/ubuntu10.04-live/
7http://tomoyo.sourceforge.jp/1.7/1st-step/centos5-live/ .
Tetsuo Handa17a7b7b2009-04-13 11:04:19 +09008Though these tutorials use non-LSM version of TOMOYO, they are useful for you
9to know what TOMOYO is.
10
11--- How to enable TOMOYO? ---
12
13Build the kernel with CONFIG_SECURITY_TOMOYO=y and pass "security=tomoyo" on
14kernel's command line.
15
Tetsuo Handae6f6a4c2010-07-27 17:17:06 +090016Please see http://tomoyo.sourceforge.jp/2.3/ for details.
Tetsuo Handa17a7b7b2009-04-13 11:04:19 +090017
18--- Where is documentation? ---
19
20User <-> Kernel interface documentation is available at
Tetsuo Handae6f6a4c2010-07-27 17:17:06 +090021http://tomoyo.sourceforge.jp/2.3/policy-reference.html .
Tetsuo Handa17a7b7b2009-04-13 11:04:19 +090022
23Materials we prepared for seminars and symposiums are available at
24http://sourceforge.jp/projects/tomoyo/docs/?category_id=532&language_id=1 .
25Below lists are chosen from three aspects.
26
27What is TOMOYO?
28 TOMOYO Linux Overview
29 http://sourceforge.jp/projects/tomoyo/docs/lca2009-takeda.pdf
30 TOMOYO Linux: pragmatic and manageable security for Linux
31 http://sourceforge.jp/projects/tomoyo/docs/freedomhectaipei-tomoyo.pdf
32 TOMOYO Linux: A Practical Method to Understand and Protect Your Own Linux Box
33 http://sourceforge.jp/projects/tomoyo/docs/PacSec2007-en-no-demo.pdf
34
35What can TOMOYO do?
36 Deep inside TOMOYO Linux
37 http://sourceforge.jp/projects/tomoyo/docs/lca2009-kumaneko.pdf
38 The role of "pathname based access control" in security.
39 http://sourceforge.jp/projects/tomoyo/docs/lfj2008-bof.pdf
40
41History of TOMOYO?
42 Realities of Mainlining
43 http://sourceforge.jp/projects/tomoyo/docs/lfj2008.pdf
44
45--- What is future plan? ---
46
47We believe that inode based security and name based security are complementary
48and both should be used together. But unfortunately, so far, we cannot enable
49multiple LSM modules at the same time. We feel sorry that you have to give up
50SELinux/SMACK/AppArmor etc. when you want to use TOMOYO.
51
52We hope that LSM becomes stackable in future. Meanwhile, you can use non-LSM
Tetsuo Handae6f6a4c2010-07-27 17:17:06 +090053version of TOMOYO, available at http://tomoyo.sourceforge.jp/1.7/ .
Tetsuo Handa17a7b7b2009-04-13 11:04:19 +090054LSM version of TOMOYO is a subset of non-LSM version of TOMOYO. We are planning
55to port non-LSM version's functionalities to LSM versions.