From 7d147decac4d0b4a328928f2168f6efe56625ded Mon Sep 17 00:00:00 2001 From: scottl Date: Thu, 7 Apr 2005 19:59:28 +0000 Subject: [PATCH] Document the GEOM debug flags. --- share/man/man4/geom.4 | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/share/man/man4/geom.4 b/share/man/man4/geom.4 index 1ba1ec64971f..e0122c3a4c85 100644 --- a/share/man/man4/geom.4 +++ b/share/man/man4/geom.4 @@ -330,6 +330,33 @@ Attributes are named by ascii strings and they will be discussed in a separate section below. .Pp (stay tuned while the author rests his brain and fingers: more to come.) +.Sh DIAGNOSTICS +Several flags are provided for tracing GEOM operations and unlocking +protection mechanisms via the +.Va kern.geom.debugflags +sysctl. +All of these flags are off by default, and great care should be taken in +turning them on. +.Bl -tag -width FAIL +.It 0x01 (G_T_TOPOLOGY) +Provide tracing of topology change events. +.It 0x02 (G_T_BIO) +Provide tracing of buffer I/O requests. +.It 0x04 (G_T_ACCESS) +Provide tracing of access check controls. +.It 0x08 (unused) +.It 0x10 (allow foot shooting) +Allow writing to Rank 1 providers. +This would, for example, allow the super-user to overwrite the MBR on the root +disk or write random sectors elsewhere to a mounted disk. The implications +are obvious. +.It 0x20 (G_T_DETAILS) +This appears to be unused at this time. +.It 0x40 (G_F_DISKIOCTL) +This appears to be unused at this time. +.It 0x80 (G_F_CTLDUMP) +Dump contents of gctl requests. +.El .Sh HISTORY This software was developed for the FreeBSD Project by Poul-Henning Kamp and NAI Labs, the Security Research Division of Network Associates, Inc.