diff options
Diffstat (limited to 'lib/libkvm')
-rw-r--r-- | lib/libkvm/kvm_geterr.3 | 4 | ||||
-rw-r--r-- | lib/libkvm/kvm_getprocs.3 | 20 | ||||
-rw-r--r-- | lib/libkvm/kvm_getswapinfo.3 | 4 | ||||
-rw-r--r-- | lib/libkvm/kvm_open.3 | 20 | ||||
-rw-r--r-- | lib/libkvm/kvm_read.3 | 6 |
5 files changed, 27 insertions, 27 deletions
diff --git a/lib/libkvm/kvm_geterr.3 b/lib/libkvm/kvm_geterr.3 index ee9506ada267..815828d49ab5 100644 --- a/lib/libkvm/kvm_geterr.3 +++ b/lib/libkvm/kvm_geterr.3 @@ -55,7 +55,7 @@ on the descriptor The results are undefined if the most recent .Xr kvm 3 library call did not produce an error. -The string returned is stored in memory owned by +The string returned is stored in memory owned by .Xr kvm 3 so the message should be copied out and saved elsewhere if necessary. .Sh BUGS @@ -65,7 +65,7 @@ call, since failure is indicated by returning a .Dv NULL descriptor. Therefore, errors on open are output to the special error buffer -passed to +passed to .Fn kvm_openfiles . This option is not available to .Fn kvm_open . diff --git a/lib/libkvm/kvm_getprocs.3 b/lib/libkvm/kvm_getprocs.3 index 89b774b8bbc5..e5e451d326fb 100644 --- a/lib/libkvm/kvm_getprocs.3 +++ b/lib/libkvm/kvm_getprocs.3 @@ -42,7 +42,7 @@ .Sh NAME .Nm kvm_getprocs , .Nm kvm_getargv , -.Nm kvm_getenvv +.Nm kvm_getenvv .Nd access user process state .Sh LIBRARY .Lb libkvm @@ -74,7 +74,7 @@ describes the filtering predicate as follows: .It Sy KERN_PROC_ALL all processes .It Sy KERN_PROC_PID -processes with process id +processes with process id .Fa arg .It Sy KERN_PROC_PGRP processes with process group @@ -97,13 +97,13 @@ The number of processes found is returned in the reference parameter .Fa cnt . The processes are returned as a contiguous array of kinfo_proc structures. This memory is locally allocated, and subsequent calls to -.Fn kvm_getprocs -and +.Fn kvm_getprocs +and .Fn kvm_close will overwrite this storage. .Pp .Fn kvm_getargv -returns a null-terminated argument vector that corresponds to the +returns a null-terminated argument vector that corresponds to the command line arguments passed to process indicated by .Fa p . Most likely, these arguments correspond to the values passed to @@ -114,7 +114,7 @@ Note that the original command name can be found, unaltered, in the p_comm field of the process structure returned by .Fn kvm_getprocs . .Pp -The +The .Fa nchr argument indicates the maximum number of characters, including null bytes, to use in building the strings. If this amount is exceeded, the string @@ -127,13 +127,13 @@ that print only a one line summary of a command and should not copy out large amounts of text only to ignore it. If .Fa nchr -is zero, no limit is imposed and all argument strings are returned in +is zero, no limit is imposed and all argument strings are returned in their entirety. .Pp The memory allocated to the argv pointers and string storage -is owned by the kvm library. Subsequent -.Fn kvm_getprocs -and +is owned by the kvm library. Subsequent +.Fn kvm_getprocs +and .Xr kvm_close 3 calls will clobber this storage. .Pp diff --git a/lib/libkvm/kvm_getswapinfo.3 b/lib/libkvm/kvm_getswapinfo.3 index 0356d90e4836..a3c44c80bad4 100644 --- a/lib/libkvm/kvm_getswapinfo.3 +++ b/lib/libkvm/kvm_getswapinfo.3 @@ -41,7 +41,7 @@ value 0 and the single .Vt kvm_swap structure will be filled with the grand total over all swap devices. The grand total is calculated -from all available swap devices whether or not you made room +from all available swap devices whether or not you made room for them all in the array. the grant total is returned. .Pp @@ -77,7 +77,7 @@ it reuses in successive calls. You may call the function with .Fa kd == -.Dv NULL +.Dv NULL to clear the cache. .Sh DIAGNOSTICS If the load average was unobtainable, \-1 is returned; otherwise, diff --git a/lib/libkvm/kvm_open.3 b/lib/libkvm/kvm_open.3 index b624b3c80ca8..c22c49cd8872 100644 --- a/lib/libkvm/kvm_open.3 +++ b/lib/libkvm/kvm_open.3 @@ -58,10 +58,10 @@ .Sh DESCRIPTION The functions .Fn kvm_open -and +and .Fn kvm_openfiles return a descriptor used to access kernel virtual memory -via the +via the .Xr kvm 3 library routines. Both active kernels and crash dumps are accessible through this interface. @@ -75,9 +75,9 @@ the currently running system is assumed, as determined from .Xr getbootfile 3 . .Pp -.Fa corefile +.Fa corefile is the kernel memory device file. It can be either /dev/mem -or a crash dump core generated by +or a crash dump core generated by .Xr savecore 8 . If .Fa corefile @@ -94,7 +94,7 @@ should indicate the swap device. If from <paths.h> is used. .Pp The -.Fa flags +.Fa flags argument indicates read/write access as in .Xr open 2 and applies only to the core file. @@ -105,7 +105,7 @@ and .Dv O_RDWR are permitted. .Pp -There are two open routines which differ only with respect to +There are two open routines which differ only with respect to the error mechanism. One provides backward compatibility with the SunOS kvm library, while the other provides an improved error reporting framework. @@ -116,11 +116,11 @@ function is the Sun kvm compatible open call. Here, the .Fa errstr argument indicates how errors should be handled. If it is .Dv NULL , -no errors are reported and the application cannot know the +no errors are reported and the application cannot know the specific nature of the failed kvm call. If it is not .Dv NULL , -errors are printed to stderr with +errors are printed to stderr with .Fa errstr prepended to the message, as in .Xr perror 3 . @@ -156,7 +156,7 @@ argument. This buffer should be _POSIX2_LINE_MAX characters large (from .Sh RETURN VALUES The .Fn kvm_open -and +and .Fn kvm_openfiles functions both return a descriptor to be used in all subsequent kvm library calls. @@ -165,7 +165,7 @@ On failure, .Dv NULL is returned, in which case .Fn kvm_openfiles -writes the error message into +writes the error message into .Fa errbuf . .Pp The diff --git a/lib/libkvm/kvm_read.3 b/lib/libkvm/kvm_read.3 index 183df72d252c..cfde604a80ba 100644 --- a/lib/libkvm/kvm_read.3 +++ b/lib/libkvm/kvm_read.3 @@ -66,19 +66,19 @@ for information regarding opening kernel virtual memory and crash dumps. The .Fn kvm_read function transfers -.Fa nbytes +.Fa nbytes bytes of data from the kernel space address .Fa addr to .Fa buf . -Conversely, +Conversely, .Fn kvm_write transfers data from .Fa buf to .Fa addr . -Unlike their SunOS counterparts, these functions cannot be used to +Unlike their SunOS counterparts, these functions cannot be used to read or write process address spaces. .Sh RETURN VALUES Upon success, the number of bytes actually transferred is returned. |