system_cmds-336.23.tar.gz

[apple/system_cmds.git] / fs_usage.tproj / fs_usage.1

diff --git a/fs_usage.tproj/fs_usage.1 b/fs_usage.tproj/fs_usage.1
index cbe57b92981d73f9c0e44d8491e7cb77010315da..4479900cef720029c20bca0b814135a3aa70b198 100644 (file)
--- a/fs_usage.tproj/fs_usage.1
+++ b/fs_usage.tproj/fs_usage.1
@@ -8,7 +8,7 @@
 .Nd report system calls and page faults related to filesystem activity in
 real-time
 .Sh SYNOPSIS
 .Nd report system calls and page faults related to filesystem activity in
 real-time
 .Sh SYNOPSIS

-.Nm fs_usage [-e] [-w] [-f mode] [ pid|cmd [pid|cmd] ...]
+.Nm fs_usage [-e] [-w] [-f mode [-f mode] ...] [ pid|cmd [pid|cmd] ...]

 .Sh DESCRIPTION
 The
 .Nm fs_usage
 .Sh DESCRIPTION
 The
 .Nm fs_usage


@@ -53,7 +53,8 @@ Specifying the
 option turns on output filtering based on the
 .Pa mode
 provided.
 option turns on output filtering based on the
 .Pa mode
 provided.

-By default no filtering occurs.
+Multiple filtering options can be specified.
+By default no output filtering occurs.

 The supported modes are:
 .Pp
 .Pa  network   
 The supported modes are:
 .Pp
 .Pa  network   


@@ -61,6 +62,9 @@ Only network related output is displayed.
 .Pp
 .Pa filesys    
 Only file system related output is displayed.
 .Pp
 .Pa filesys    
 Only file system related output is displayed.

+.Pp
+.Pa cachehit   
+In addition, display CACHE_HIT output.

 .It  pid | cmd
 The sampled data can be limited to a list of process ids or commands.
 When a command name is given, all processes with that name will be sampled.
 .It  pid | cmd
 The sampled data can be limited to a list of process ids or commands.
 When a command name is given, all processes with that name will be sampled.


@@ -105,6 +109,8 @@ Of the form A=0xnnnnnnnn, where 0xnnnnnnnn is the address being faulted.
 .It DISK BLOCK NUMBER
 Of the form D=0xnnnnnnnn, where 0xnnnnnnnn is the block number of the physical
 disk block being read or written.
 .It DISK BLOCK NUMBER
 Of the form D=0xnnnnnnnn, where 0xnnnnnnnn is the block number of the physical
 disk block being read or written.

+.It OFFSET    
+Of the form O=0xnnnnnnnn, where 0xnnnnnnnn is a file offset.

 .It SELECT RETURN
 Of the form S=x, x is the number of ready descriptors returned by the select()
 system call.
 .It SELECT RETURN
 Of the form S=x, x is the number of ready descriptors returned by the select()
 system call.