1====== 2TOMOYO 3====== 4 5What is TOMOYO? 6=============== 7 8TOMOYO is a name-based MAC extension (LSM module) for the Linux kernel. 9 10LiveCD-based tutorials are available at 11 12http://tomoyo.sourceforge.jp/1.8/ubuntu12.04-live.html 13http://tomoyo.sourceforge.jp/1.8/centos6-live.html 14 15Though these tutorials use non-LSM version of TOMOYO, they are useful for you 16to know what TOMOYO is. 17 18How to enable TOMOYO? 19===================== 20 21Build the kernel with ``CONFIG_SECURITY_TOMOYO=y`` and pass ``security=tomoyo`` on 22kernel's command line. 23 24Please see http://tomoyo.osdn.jp/2.5/ for details. 25 26Where is documentation? 27======================= 28 29User <-> Kernel interface documentation is available at 30https://tomoyo.osdn.jp/2.5/policy-specification/index.html . 31 32Materials we prepared for seminars and symposiums are available at 33https://osdn.jp/projects/tomoyo/docs/?category_id=532&language_id=1 . 34Below lists are chosen from three aspects. 35 36What is TOMOYO? 37 TOMOYO Linux Overview 38 https://osdn.jp/projects/tomoyo/docs/lca2009-takeda.pdf 39 TOMOYO Linux: pragmatic and manageable security for Linux 40 https://osdn.jp/projects/tomoyo/docs/freedomhectaipei-tomoyo.pdf 41 TOMOYO Linux: A Practical Method to Understand and Protect Your Own Linux Box 42 https://osdn.jp/projects/tomoyo/docs/PacSec2007-en-no-demo.pdf 43 44What can TOMOYO do? 45 Deep inside TOMOYO Linux 46 https://osdn.jp/projects/tomoyo/docs/lca2009-kumaneko.pdf 47 The role of "pathname based access control" in security. 48 https://osdn.jp/projects/tomoyo/docs/lfj2008-bof.pdf 49 50History of TOMOYO? 51 Realities of Mainlining 52 https://osdn.jp/projects/tomoyo/docs/lfj2008.pdf 53 54What is future plan? 55==================== 56 57We believe that inode based security and name based security are complementary 58and both should be used together. But unfortunately, so far, we cannot enable 59multiple LSM modules at the same time. We feel sorry that you have to give up 60SELinux/SMACK/AppArmor etc. when you want to use TOMOYO. 61 62We hope that LSM becomes stackable in future. Meanwhile, you can use non-LSM 63version of TOMOYO, available at http://tomoyo.osdn.jp/1.8/ . 64LSM version of TOMOYO is a subset of non-LSM version of TOMOYO. We are planning 65to port non-LSM version's functionalities to LSM versions. 66