OSDN Git Service

Release docs/kernel-docs-2.6/filesystems/btrfs.txt [JF:20135]
authorMasanori Kobayasi <yasikoba@users.sourceforge.jp>
Mon, 28 Jan 2013 15:20:09 +0000 (00:20 +0900)
committerMasanori Kobayasi <yasikoba@users.sourceforge.jp>
Mon, 28 Jan 2013 15:20:09 +0000 (00:20 +0900)
docs/kernel-docs-2.6/filesystems/btrfs.txt [new file with mode: 0644]
docs/kernel-docs-2.6/filesystems/btrfs.txt.info [new file with mode: 0644]
lists/kdoc-2.6-reserved.list
www/news.m4

diff --git a/docs/kernel-docs-2.6/filesystems/btrfs.txt b/docs/kernel-docs-2.6/filesystems/btrfs.txt
new file mode 100644 (file)
index 0000000..165ef05
--- /dev/null
@@ -0,0 +1,145 @@
+=========================================================
+¤³¤ì¤Ï¡¢
+Linux-3.7/Documentation/filesystems/btrfs.txt ¤ÎÏÂÌõ¤Ç¤¹¡£
+ËÝÌõÃÄÂΡ§ JF ¥×¥í¥¸¥§¥¯¥È < http://linuxjf.sourceforge.jp/ >
+¹¹¿·Æü ¡§ 2013/01/09
+ËÝÌõ¼Ô ¡§ Seiji Kaneko < skaneko at a2 dot mbn dot or dot jp >
+=========================================================
+
+       BTRFS
+       =====
+
+#Btrfs is a new copy on write filesystem for Linux aimed at
+#implementing advanced features while focusing on fault tolerance,
+#repair and easy administration. Initially developed by Oracle, Btrfs
+#is licensed under the GPL and open for contribution from anyone.
+Btrfs ¤Ï Linux ¸þ¤±¤Î¥³¥Ô¡¼¥ª¥ó¥é¥¤¥È¥¿¥¤¥×¤Î¿·¤·¤¤¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ç¡¢ÂѾã
+³²À­¡¢²óÉü½èÍý¤È´ÉÍý¤ÎÍưײ½¤Ë½ÅÅÀ¤òÃÖ¤­¤Ä¤ÄÀè¿ÊŪ¤Êµ¡Ç½¤ò¼ÂÁõ¤¹¤ë¤³¤È¤òÁÀ
+¤Ã¤¿¤â¤Î¤Ç¤¹¡£ºÇ½é¤Ï Oracle ¼Ò¤Ç³«È¯¤¬¹Ô¤ï¤ì¤Æ¤¤¤Þ¤·¤¿¤¬¡¢¸½ºß¤Ï GPL ¤Ç¥é¥¤
+¥»¥ó¥¹¤µ¤ì¡¢Ã¯¤«¤é¤Î¹×¸¥¤Ç¤â¼õ¤±Æþ¤ì¤Æ¤¤¤Þ¤¹¡£
+
+#Linux has a wealth of filesystems to choose from, but we are facing a
+#number of challenges with scaling to the large storage subsystems that
+#are becoming common in today's data centers. Filesystems need to scale
+#in their ability to address and manage large storage, and also in
+#their ability to detect, repair and tolerate errors in the data stored
+#on disk.  Btrfs is under heavy development, and is not suitable for
+#any uses other than benchmarking and review. The Btrfs disk format is
+#not yet finalized.
+Linux ¤Ç¤ÏÁªÂò²Äǽ¤Ê¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬Ë­É٤ˤ¢¤ê¤Þ¤¹¤¬¡¢»äã¤Ï¸½ºß¤Î¥Ç¡¼¥¿
+¥»¥ó¥¿¡¼´Ä¶­¤Ç°ìÈÌŪ¤Ë¤Ê¤ê¤Ä¤Ä¤¢¤ë¤è¤¦¤ÊµðÂç¤Ê¥¹¥È¥ì¡¼¥¸¥µ¥Ö¥·¥¹¥Æ¥à¤Þ¤Ç¤Î
+³ÈÄ¥À­¤ò¼Â¸½¤¹¤ë¤¿¤á¤Ë¡¢ÍÍ¡¹¤Êµ»½ÑŪĩÀï¤Ë¼è¤êÁȤó¤Ç¤­¤Þ¤·¤¿¡£¥Õ¥¡¥¤¥ë¥·¥¹¥Æ
+¥à¤ÏµðÂç¤Ê¥¹¥È¥ì¡¼¥¸¤ò¥¢¥¯¥»¥¹¤ª¤è¤Ó´ÉÍý¤¹¤ëµ¡Ç½¤òÈ÷¤¨¤Æ³ÈÄ¥¤Ç¤­¤ëɬÍפ¬¤¢
+¤ê¡¢¤Þ¤¿¥Ç¥£¥¹¥¯¾å¤Î¥Ç¡¼¥¿¤Î¥¨¥é¡¼¤Îȯ¸«¡¦½¤Éü¡¦ÂѾ㳲À­¤¬¼Â¸½¤µ¤ì¤Ê¤±¤ì¤Ð
+¤¤¤±¤Þ¤»¤ó¡£Btrfs ¤Ï¸½ºß±Ô°Õ³«È¯Ãæ¤Ç¤¢¤ê¡¢¥Ù¥ó¥Á¥Þ¡¼¥¯¤ò¼è¤ë¤³¤È¤È¥ì¥Ó¥å¡¼
+¤ò¹Ô¤¦¤³¤È°Ê³°¤ÎÌÜŪ¤Ë¤ÏŬ¤·¤Æ¤¤¤Þ¤»¤ó¡£Btrfs ¤Î¥Ç¥£¥¹¥¯¥Õ¥©¡¼¥Þ¥Ã¥È¤âºÇ½ª
+ÈǤȤϤʤäƤ¤¤Þ¤»¤ó¡£
+
+#The main Btrfs features include:
+Btrfs ¤Î¼ç¤Êµ¡Ç½¤Ë¤Ï°Ê²¼¤Î¤â¤Î¤¬´Þ¤Þ¤ì¤Þ¤¹¡£
+
+#    * Extent based file storage (2^64 max file size)
+#    * Space efficient packing of small files
+#    * Space efficient indexed directories
+#    * Dynamic inode allocation
+#    * Writable snapshots
+#    * Subvolumes (separate internal filesystem roots)
+#    * Object level mirroring and striping
+#    * Checksums on data and metadata (multiple algorithms available)
+#    * Compression
+#    * Integrated multiple device support, with several raid algorithms
+#    * Online filesystem check (not yet implemented)
+#    * Very fast offline filesystem check
+#    * Efficient incremental backup and FS mirroring (not yet implemented)
+#    * Online filesystem defragmentation
+    * ¥¨¥¯¥¹¥Æ¥ó¥È¥Ù¡¼¥¹¤Î¥Õ¥¡¥¤¥ë¥¹¥È¥ì¡¼¥¸ (ºÇÂç¥Õ¥¡¥¤¥ë¥µ¥¤¥º 2^64 ¥Ð¥¤¥È)
+    * ¾®¤µ¤Ê¥Õ¥¡¥¤¥ë¤òÊ£¿ôµÍ¤á¹þ¤à¤³¤È¤Ë¤è¤ëÍÆÎ̤θúΨŪÍøÍÑ
+    * ¥¤¥ó¥Ç¥Ã¥¯¥¹¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤è¤ëÍÆÎ̤θúΨŪÍøÍÑ
+    * Æ°Åª¤Ê inode ¤Î³ä¤êÅö¤Æ
+    * ½ñ¤­´¹¤¨²Äǽ¤Ê¥¹¥Ê¥Ã¥×¥·¥ç¥Ã¥Èµ¡Ç½
+    * ¥µ¥Ö¥Ü¥ê¥å¡¼¥à (ÆâÉô¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥ë¡¼¥È¤òÊ£¿ô»ý¤Ä¤³¤È¤¬²Äǽ)
+    * ¥ª¥Ö¥¸¥§¥¯¥È¥ì¥Ù¥ë¤Î¥ß¥é¡¼¥ê¥ó¥°¤È¥¹¥È¥é¥¤¥Ô¥ó¥°
+    * ¥Ç¡¼¥¿¤È¥á¥¿¥Ç¡¼¥¿¤Î¥Á¥§¥Ã¥¯¥µ¥à (Ê£¿ô¤Î¥¢¥ë¥´¥ê¥º¥à¤¬»ØÄê²Äǽ)
+    * °µ½Ìµ¡Ç½
+    * ¤¤¤¯¤Ä¤«¤Î RAID ¥¢¥ë¥´¥ê¥º¥à¤òÄ󶡤¹¤ë¡¢Ê£¿ô¥Ç¥Ð¥¤¥¹¥µ¥Ý¡¼¥Èµ¡Ç½¤ÎÅý¹ç
+    * ¥ª¥ó¥é¥¤¥ó¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥Á¥§¥Ã¥¯ (̤¼ÂÁõ)
+    * ¤È¤Æ¤â¹â®¤Ê¥ª¥Õ¥é¥¤¥ó¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥Á¥§¥Ã¥¯
+    * ¸úΨŪ¤Êº¹Ê¬¥Ð¥Ã¥¯¥¢¥Ã¥×¤È¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥ß¥é¡¼¥ê¥ó¥° (̤¼ÂÁõ)
+    * ¥ª¥ó¥é¥¤¥ó¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥Ç¥Õ¥é¥°µ¡Ç½
+
+
+
+#      MAILING LIST
+#      ============
+       ¥á¡¼¥ê¥ó¥°¥ê¥¹¥È
+       ================
+
+#There is a Btrfs mailing list hosted on vger.kernel.org. You can
+#find details on how to subscribe here:
+vgar.kernel.org ¤Ç¥Û¥¹¥Æ¥£¥ó¥°¤µ¤ì¤Æ¤¤¤ë Btrfs ¥á¡¼¥ê¥ó¥°¥ê¥¹¥È¤¬Í­¤ê¤Þ¤¹¡£
+¹ØÆɤΤ¿¤á¤Î¾ÜºÙ¤Ï°Ê²¼¤ò¤´Í÷¤¯¤À¤µ¤¤¡£
+
+http://vger.kernel.org/vger-lists.html#linux-btrfs
+
+#Mailing list archives are available from gmane:
+¥á¡¼¥ê¥ó¥°¥ê¥¹¥È¥¢¡¼¥«¥¤¥Ö¤Ï¡¢gmane ¤ÇÄ󶡤µ¤ì¤Æ¤¤¤Þ¤¹¡£
+
+http://dir.gmane.org/gmane.comp.file-systems.btrfs
+
+
+
+       IRC
+       ===
+
+#Discussion of Btrfs also occurs on the #btrfs channel of the Freenode
+#IRC network.
+Btrfs ¤Ë´Ø¤¹¤ëµÄÏÀ¤Ï¡¢Freenode IRC ¥Í¥Ã¥È¥ï¡¼¥¯¤Î #btrfs ¥Á¥ã¥Í¥ë¤Ç¤â¹Ô¤ï¤ì
+¤Æ¤¤¤Þ¤¹¡£
+
+
+
+#      UTILITIES
+#      =========
+       ¥æ¡¼¥Æ¥£¥ê¥Æ¥£
+       ==============
+
+#Userspace tools for creating and manipulating Btrfs file systems are
+#available from the git repository at the following location:
+Btrfs ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤òºîÀ®¡¦´ÉÍý¤¹¤ë¤¿¤á¤Î¥æ¡¼¥¶¶õ´Ö¥Ä¡¼¥ë¤Ï°Ê²¼¤Î git ¥ê
+¥Ý¥¸¥È¥ê¤«¤éÆþ¼ê¤Ç¤­¤Þ¤¹¡£
+
+ http://git.kernel.org/?p=linux/kernel/git/mason/btrfs-progs.git
+ git://git.kernel.org/pub/scm/linux/kernel/git/mason/btrfs-progs.git
+
+#These include the following tools:
+¤³¤³¤Ç¤Ï¡¢°Ê²¼¤Î¥Ä¡¼¥ë¤¬Æþ¼ê¤Ç¤­¤Þ¤¹¡£
+
+#mkfs.btrfs: create a filesystem
+mkfs.btrfs: ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤òºîÀ®¤¹¤ë¥Ä¡¼¥ë
+
+#btrfsctl: control program to create snapshots and subvolumes:
+btrfsctl:   ¥¹¥Ê¥Ã¥×¥·¥ç¥Ã¥È¤È¥µ¥Ö¥Ü¥ê¥å¡¼¥à¤òºîÀ®¤¹¤ëÀ©¸æ¥×¥í¥°¥é¥à
+
+       mount /dev/sda2 /mnt
+       btrfsctl -s new_subvol_name /mnt
+       btrfsctl -s snapshot_of_default /mnt/default
+       btrfsctl -s snapshot_of_new_subvol /mnt/new_subvol_name
+       btrfsctl -s snapshot_of_a_snapshot /mnt/snapshot_of_new_subvol
+       ls /mnt
+       default snapshot_of_a_snapshot snapshot_of_new_subvol
+       new_subvol_name snapshot_of_default
+
+#      Snapshots and subvolumes cannot be deleted right now, but you can
+#      rm -rf all the files and directories inside them.
+       ¥¹¥Ê¥Ã¥×¥·¥ç¥Ã¥È¤È¥µ¥Ö¥Ü¥ê¥å¡¼¥à¤Ï¸½ºß¤Î¤È¤³¤íºï½ü¤Ç¤­¤Þ¤»¤ó¤¬¡¢Æâ
+       Éô¤ÎÁ´¤Æ¤Î¥Õ¥¡¥¤¥ë¤È¥Ç¥£¥ì¥¯¥È¥ê¤Ï rm -rf ¤Çºï½ü¤Ç¤­¤Þ¤¹¡£
+
+#btrfsck: do a limited check of the FS extent trees.
+btrfsck:   ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥¨¥¯¥¹¥Æ¥ó¥ÈÌڤˡ¢¸ÂÄꤵ¤ì¤¿¥Á¥§¥Ã¥¯¤ò¹Ô¤¦¡£
+
+#btrfs-debug-tree: print all of the FS metadata in text form.  Example:
+btrfs-debug-tree: Á´¤Æ¤Î¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¥á¥¿¥Ç¡¼¥¿¤ò¥Æ¥­¥¹¥È·Á¼°¤Ç½ÐÎϤ·¤Þ
+¤¹¡£»È¤¤Êý¤ò°Ê²¼¤Ë¼¨¤·¤Þ¤¹¡£
+
+       btrfs-debug-tree /dev/sda2 >& big_output_file
+       
diff --git a/docs/kernel-docs-2.6/filesystems/btrfs.txt.info b/docs/kernel-docs-2.6/filesystems/btrfs.txt.info
new file mode 100644 (file)
index 0000000..3d0cb11
--- /dev/null
@@ -0,0 +1,7 @@
+TITL: Btrfs.txt
+CONT: Linux Btrfs ¤Î²òÀâ
+NAME: filesystems/btrfs.txt
+JDAT: 2013/01/09
+BVER: 3.7
+AUTH: unknown
+TRNS: Seiji Kaneko < skaneko at a2 dot mbn dot or dot jp >
index 0a89892..e42bfff 100644 (file)
@@ -630,11 +630,11 @@ NOTE: [JF:20083]
 # STAT: Release
 # NOTE: [JF:20103]
 
-NAME: filesystems/btrfs.txt
-TRNS: skaneko@a2.mbn.or.jp
-PDAT: 2012/09/05
-STAT: Draft
-NOTE: [JF:20112]
+NAME: filesystems/btrfs.txt
+TRNS: skaneko@a2.mbn.or.jp
+PDAT: 2012/09/05
+# STAT: Release
+NOTE: [JF:20112]
 
 NAME: filesystems/xfs-delayed-logging-design.txt
 TRNS: skaneko@a2.mbn.or.jp
index ad22bf1..eba1dd9 100644 (file)
@@ -45,6 +45,9 @@ m4_define(`_NEW_DOC',`
    </DT>')
 
  <DL>
+_NEW_DOC(kernel-docs-2.6/filesystems/btrfs.txt.html,2013/01/29,
+       `kernel-3.7 ÉÕ° filesystems/btrfs.txt ¤ÎÆüËܸìÌõ')
+
 _NEW_DOC(kernel-docs-2.6/filesystems/Locking.html,2012/10/04,
        `kernel-3.6 ÉÕ° filesystems/Locking ¤ÎÆüËܸìÌõ')