LXR linux/Documentation/tomoyo.txt

   1--- What is TOMOYO? ---
   2
   3TOMOYO is a name-based MAC extension (LSM module) for the Linux kernel.
   4
   5LiveCD-based tutorials are available at
   6http://tomoyo.sourceforge.jp/en/1.6.x/1st-step/ubuntu8.04-live/
   7http://tomoyo.sourceforge.jp/en/1.6.x/1st-step/centos5-live/ .
   8Though 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
  16Please see http://tomoyo.sourceforge.jp/en/2.2.x/ for details.
  17
  18--- Where is documentation? ---
  19
  20User <-> Kernel interface documentation is available at
  21http://tomoyo.sourceforge.jp/en/2.2.x/policy-reference.html .
  22
  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
  53version of TOMOYO, available at http://tomoyo.sourceforge.jp/en/1.6.x/ .
  54LSM 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.
  56