From 4bd8c61461cb544142a0eef1af9409a27414516f Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 14 Dec 2007 13:23:07 +0000 Subject: [PATCH] ffix --- man2/getpagesize.2 | 7 +++++-- man2/ioctl_list.2 | 3 ++- man3/dbopen.3 | 8 ++++++-- man3/getlogin.3 | 2 +- man3/mpool.3 | 14 ++++++++++---- man3/recno.3 | 10 ++++++---- man4/initrd.4 | 8 ++++++-- 7 files changed, 36 insertions(+), 16 deletions(-) diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index b5102117c..a392d9a6e 100644 --- a/man2/getpagesize.2 +++ b/man2/getpagesize.2 @@ -82,13 +82,16 @@ instead of this call. Whether .BR getpagesize () is present as a Linux system call depends on the architecture. -If it is, it returns the kernel symbol PAGE_SIZE, +If it is, it returns the kernel symbol +.BR PAGE_SIZE , which is architecture and machine model dependent. Generally, one uses binaries that are architecture but not machine model dependent, in order to have a single binary distribution per architecture. This means that a user program -should not find PAGE_SIZE at compile time from a header file, +should not find +.B PAGE_SIZE +at compile time from a header file, but use an actual system call, at least for those architectures (like sun4) where this dependency exists. Here libc4, libc5, glibc 2.0 fail because their diff --git a/man2/ioctl_list.2 b/man2/ioctl_list.2 index 6315357c2..b1e2a2037 100644 --- a/man2/ioctl_list.2 +++ b/man2/ioctl_list.2 @@ -27,7 +27,8 @@ ioctl_list \- list of ioctl calls in Linux/i386 kernel .SH DESCRIPTION This is Ioctl List 1.3.27, a list of ioctl calls in Linux/i386 kernel 1.3.27. -It contains 421 ioctls from /usr/include/{asm,linux}/*.h. +It contains 421 ioctls from +.IR /usr/include/{asm,linux}/*.h . For each ioctl, its numerical value, its name, and its argument type are given. .PP diff --git a/man3/dbopen.3 b/man3/dbopen.3 index eb6aec2f9..882584c8b 100644 --- a/man3/dbopen.3 +++ b/man3/dbopen.3 @@ -131,8 +131,12 @@ is NULL, each access method will use defaults appropriate for the system and the access method. .PP .BR dbopen () -returns a pointer to a DB structure on success and NULL on error. -The DB structure is defined in the +returns a pointer to a +.I DB +structure on success and NULL on error. +The +.I DB +structure is defined in the .I include file, and contains at least the following fields: diff --git a/man3/getlogin.3 b/man3/getlogin.3 index 0ee725a6b..9710382e7 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -184,7 +184,7 @@ Or avoid it altogether: use .I getpwuid(geteuid()) instead, if that is what you meant. -DO NOT USE +.B Do not use .BR cuserid (). .SH "SEE ALSO" .BR geteuid (2), diff --git a/man3/mpool.3 b/man3/mpool.3 index e3580b985..1e0c63760 100644 --- a/man3/mpool.3 +++ b/man3/mpool.3 @@ -121,7 +121,9 @@ pointer, the page number and a pointer to the page to being read or written. .PP The function .BR mpool_new () -takes an MPOOL pointer and an address as arguments. +takes an +.I MPOOL +pointer and an address as arguments. If a new page can be allocated, a pointer to the page is returned and the page number is stored into the .I pgnoaddr @@ -132,7 +134,9 @@ is set. .PP The function .BR mpool_get () -takes a MPOOL pointer and a page number as arguments. +takes an +.I MPOOL +pointer and a page number as arguments. If the page exists, a pointer to the page is returned. Otherwise, NULL is returned and .I errno @@ -152,7 +156,7 @@ The flag value is specified by .IR or 'ing any of the following values: .TP -MPOOL_DIRTY +.B MPOOL_DIRTY The page has been modified and needs to be written to the backing file. .PP .BR mpool_put () @@ -160,7 +164,9 @@ returns 0 on success and \-1 if an error occurs. .PP The function .BR mpool_sync () -writes all modified pages associated with the MPOOL pointer to the +writes all modified pages associated with the +.I MPOOL +pointer to the backing file. .BR mpool_sync () returns 0 on success and \-1 if an error occurs. diff --git a/man3/recno.3 b/man3/recno.3 index 93ff88a6e..996a6712d 100644 --- a/man3/recno.3 +++ b/man3/recno.3 @@ -86,7 +86,7 @@ The flag value is specified by any of the following values: .RS .TP -R_FIXEDLEN +.B R_FIXEDLEN The records are fixed-length, not byte delimited. The structure element .I reclen @@ -97,18 +97,20 @@ Any records, inserted into the database, that are less than .I reclen bytes long are automatically padded. .TP -R_NOKEY +.B R_NOKEY In the interface specified by .IR dbopen , the sequential record retrieval fills in both the caller's key and data structures. -If the R_NOKEY flag is specified, the +If the +.B R_NOKEY +flag is specified, the .I cursor routines are not required to fill in the key structure. This permits applications to retrieve records at the end of files without reading all of the intervening records. .TP -R_SNAPSHOT +.B R_SNAPSHOT This flag requires that a snapshot of the file be taken when .I dbopen is called, instead of permitting any unmodified records to be read from diff --git a/man4/initrd.4 b/man4/initrd.4 index 1d73d5841..a1cca1b98 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -403,11 +403,15 @@ entries are not updated. With the current kernel, if directory .IR /initrd " does not exist, then " .I /dev/ram0 -will NOT be fully unmounted if +will +.B not +be fully unmounted if .I /dev/ram0 is used by any process or has any file-system mounted on it. If -.IR /dev/ram0 " is NOT fully unmounted, " +.IR /dev/ram0 " is +.B not +fully unmounted, " then .I /dev/ram0 will remain in memory.