aboutsummaryrefslogtreecommitdiffstats
path: root/man3
diff options
context:
space:
mode:
Diffstat (limited to 'man3')
-rw-r--r--man3/bsearch.32
-rw-r--r--man3/clearenv.32
-rw-r--r--man3/cmsg.324
-rw-r--r--man3/fgetpwent.320
-rw-r--r--man3/frexp.32
-rw-r--r--man3/ftime.38
-rw-r--r--man3/getmntent.319
-rw-r--r--man3/getnetent.315
-rw-r--r--man3/getprotoent.313
-rw-r--r--man3/getpw.316
-rw-r--r--man3/getservent.311
-rw-r--r--man3/hsearch.310
-rw-r--r--man3/mq_open.32
-rw-r--r--man3/printf.374
-rw-r--r--man3/sockatmark.32
-rw-r--r--man3/stdarg.383
-rw-r--r--man3/strftime.317
-rw-r--r--man3/termios.32
18 files changed, 163 insertions, 159 deletions
diff --git a/man3/bsearch.3 b/man3/bsearch.3
index cd8e124214..5bf5591467 100644
--- a/man3/bsearch.3
+++ b/man3/bsearch.3
@@ -99,7 +99,7 @@ main(int argc, char **argv)
if (res == NULL)
printf("'%s': unknown month\en", argv[i]);
else
- printf("%s: month #%d\en", res->name, res->nr);
+ printf("%s: month #%d\en", res->name, res->nr);
}
return 0;
}
diff --git a/man3/clearenv.3 b/man3/clearenv.3
index c2a97eba5a..1167e2a118 100644
--- a/man3/clearenv.3
+++ b/man3/clearenv.3
@@ -55,7 +55,7 @@ Used in security-conscious applications. If it is unavailable
the assignment
.RS
.nf
- environ = NULL;
+ environ = NULL;
.fi
.RE
will probably do.
diff --git a/man3/cmsg.3 b/man3/cmsg.3
index 65c6ad2615..ad55be69aa 100644
--- a/man3/cmsg.3
+++ b/man3/cmsg.3
@@ -143,20 +143,20 @@ int received_ttl;
/* Receive auxiliary data in msgh */
for (cmsg = CMSG_FIRSTHDR(&msgh);
- cmsg != NULL;
- cmsg = CMSG_NXTHDR(&msgh,cmsg)) {
- if (cmsg->cmsg_level == IPPROTO_IP
- && cmsg->cmsg_type == IP_TTL) {
- ttlptr = (int *) CMSG_DATA(cmsg);
- received_ttl = *ttlptr;
- break;
- }
+ cmsg != NULL;
+ cmsg = CMSG_NXTHDR(&msgh,cmsg)) {
+ if (cmsg->cmsg_level == IPPROTO_IP
+ && cmsg->cmsg_type == IP_TTL) {
+ ttlptr = (int *) CMSG_DATA(cmsg);
+ received_ttl = *ttlptr;
+ break;
+ }
}
if (cmsg == NULL) {
- /*
- * Error: IP_TTL not enabled or small buffer
- * or I/O error.
- */
+ /*
+ * Error: IP_TTL not enabled or small buffer
+ * or I/O error.
+ */
}
.ta
.fi
diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3
index 90e2c8e2a1..ed3d601231 100644
--- a/man3/fgetpwent.3
+++ b/man3/fgetpwent.3
@@ -48,21 +48,19 @@ entries. The file \fIstream\fP must have the same format as
.PP
The \fIpasswd\fP structure is defined in \fI<pwd.h>\fP as follows:
.sp
-.RS
+.in +0.5i
.nf
-.ta 8n 16n 32n
struct passwd {
- char *pw_name; /* user name */
- char *pw_passwd; /* user password */
- uid_t pw_uid; /* user ID */
- gid_t pw_gid; /* group ID */
- char *pw_gecos; /* real name */
- char *pw_dir; /* home directory */
- char *pw_shell; /* shell program */
+ char *pw_name; /* user name */
+ char *pw_passwd; /* user password */
+ uid_t pw_uid; /* user ID */
+ gid_t pw_gid; /* group ID */
+ char *pw_gecos; /* real name */
+ char *pw_dir; /* home directory */
+ char *pw_shell; /* shell program */
};
-.ta
.fi
-.RE
+.in -0.5i
.SH "RETURN VALUE"
The \fBfgetpwent\fP() function returns the passwd structure, or NULL if
there are no more entries or an error occurs.
diff --git a/man3/frexp.3 b/man3/frexp.3
index 7b318f2d75..72a2730db7 100644
--- a/man3/frexp.3
+++ b/man3/frexp.3
@@ -78,7 +78,7 @@ main(int argc, char *argv[])
r = frexp(x, &exp);
printf("frexp(%g, &e) = %g: %g * %d^%d = %g\\n",
- x, r, r, FLT_RADIX, exp, x);
+ x, r, r, FLT_RADIX, exp, x);
exit(EXIT_SUCCESS);
} /* main */
.fi
diff --git a/man3/ftime.3 b/man3/ftime.3
index b34df61971..cd6f3d5572 100644
--- a/man3/ftime.3
+++ b/man3/ftime.3
@@ -42,10 +42,10 @@ which is declared as follows:
.in +1i
.nf
struct timeb {
- time_t time;
- unsigned short millitm;
- short timezone;
- short dstflag;
+ time_t time;
+ unsigned short millitm;
+ short timezone;
+ short dstflag;
};
.fi
.in -1i
diff --git a/man3/getmntent.3 b/man3/getmntent.3
index ed9647f2c4..7f43c9ad99 100644
--- a/man3/getmntent.3
+++ b/man3/getmntent.3
@@ -93,21 +93,18 @@ of size
.PP
The \fImntent\fP structure is defined in \fI<mntent.h>\fP as follows:
.sp
-.RS
+.in +0.5i
.nf
-.ne 8
-.ta 8n 16n 32n
struct mntent {
- char *mnt_fsname; /* name of mounted file system */
- char *mnt_dir; /* file system path prefix */
- char *mnt_type; /* mount type (see mntent.h) */
- char *mnt_opts; /* mount options (see mntent.h) */
- int mnt_freq; /* dump frequency in days */
- int mnt_passno; /* pass number on parallel fsck */
+ char *mnt_fsname; /* name of mounted file system */
+ char *mnt_dir; /* file system path prefix */
+ char *mnt_type; /* mount type (see mntent.h) */
+ char *mnt_opts; /* mount options (see mntent.h) */
+ int mnt_freq; /* dump frequency in days */
+ int mnt_passno; /* pass number on parallel fsck */
};
-.ta
.fi
-.RE
+.in -0.5i
Since fields in the mtab and fstab files are separated by whitespace,
octal escapes are used to represent the four characters space (\e040),
diff --git a/man3/getnetent.3 b/man3/getnetent.3
index 053d84d5bb..15756fe026 100644
--- a/man3/getnetent.3
+++ b/man3/getnetent.3
@@ -66,19 +66,16 @@ The \fBendnetent\fP() function closes \fI/etc/networks\fP.
.PP
The \fInetent\fP structure is defined in \fI<netdb.h>\fP as follows:
.sp
-.RS
+.in +0.5i
.nf
-.ne 6
-.ta 8n 16n 34n
struct netent {
- char *n_name; /* official network name */
- char **n_aliases; /* alias list */
- int n_addrtype; /* net address type */
- unsigned long int n_net; /* network number */
+ char *n_name; /* official network name */
+ char **n_aliases; /* alias list */
+ int n_addrtype; /* net address type */
+ unsigned long n_net; /* network number */
}
-.ta
.fi
-.RE
+.in -0.5i
.PP
The members of the \fInetent\fP structure are:
.TP
diff --git a/man3/getprotoent.3 b/man3/getprotoent.3
index f5d91abb40..a6357764db 100644
--- a/man3/getprotoent.3
+++ b/man3/getprotoent.3
@@ -65,18 +65,15 @@ The \fBendprotoent\fP() function closes \fI/etc/protocols\fP.
.PP
The \fIprotoent\fP structure is defined in \fI<netdb.h>\fP as follows:
.sp
-.RS
+.in +0.5i
.nf
-.ne 5
-.ta 8n 16n 32n
struct protoent {
- char *p_name; /* official protocol name */
- char **p_aliases; /* alias list */
- int p_proto; /* protocol number */
+ char *p_name; /* official protocol name */
+ char **p_aliases; /* alias list */
+ int p_proto; /* protocol number */
}
-.ta
.fi
-.RE
+.in -0.5i
.PP
The members of the \fIprotoent\fP structure are:
.TP
diff --git a/man3/getpw.3 b/man3/getpw.3
index cbb2329099..986ddc6f97 100644
--- a/man3/getpw.3
+++ b/man3/getpw.3
@@ -50,17 +50,15 @@ The \fIpasswd\fP structure is defined in \fI<pwd.h>\fP as follows:
.sp
.RS
.nf
-.ta 8n 16n 32n
struct passwd {
- char *pw_name; /* user name */
- char *pw_passwd; /* user password */
- uid_t pw_uid; /* user ID */
- gid_t pw_gid; /* group ID */
- char *pw_gecos; /* real name */
- char *pw_dir; /* home directory */
- char *pw_shell; /* shell program */
+ char *pw_name; /* user name */
+ char *pw_passwd; /* user password */
+ uid_t pw_uid; /* user ID */
+ gid_t pw_gid; /* group ID */
+ char *pw_gecos; /* real name */
+ char *pw_dir; /* home directory */
+ char *pw_shell; /* shell program */
};
-.ta
.fi
.RE
.SH "RETURN VALUE"
diff --git a/man3/getservent.3 b/man3/getservent.3
index 1b5c7a6257..a2162a8ad0 100644
--- a/man3/getservent.3
+++ b/man3/getservent.3
@@ -74,15 +74,12 @@ The \fIservent\fP structure is defined in \fI<netdb.h>\fP as follows:
.sp
.RS
.nf
-.ne 6
-.ta 8n 16n 32n
struct servent {
- char *s_name; /* official service name */
- char **s_aliases; /* alias list */
- int s_port; /* port number */
- char *s_proto; /* protocol to use */
+ char *s_name; /* official service name */
+ char **s_aliases; /* alias list */
+ int s_port; /* port number */
+ char *s_proto; /* protocol to use */
}
-.ta
.fi
.RE
.PP
diff --git a/man3/hsearch.3 b/man3/hsearch.3
index 8668e75c1c..15482878a6 100644
--- a/man3/hsearch.3
+++ b/man3/hsearch.3
@@ -71,12 +71,14 @@ the hash table so that a new table can be constructed.
.PP
The argument \fIitem\fP is of type \fBENTRY\fP, which is a typedef defined in
\fI<search.h>\fP and includes these elements:
+.RS
.sp
.nf
- typedef struct entry {
- char *\fIkey\fP;
- void *\fIdata\fP;
- } ENTRY;
+typedef struct entry {
+ char *\fIkey\fP;
+ void *\fIdata\fP;
+} ENTRY;
+.RE
.fi
.sp
The field \fIkey\fP points to the null-terminated string which is the
diff --git a/man3/mq_open.3 b/man3/mq_open.3
index d826c9ca1a..c6c66303c4 100644
--- a/man3/mq_open.3
+++ b/man3/mq_open.3
@@ -96,7 +96,7 @@ then two additional arguments must be supplied.
The
.I mode
argument specifies the permissions to be placed on the new queue,
- as for
+as for
.BR open (2).
The permissions settings are masked against the process umask.
The
diff --git a/man3/printf.3 b/man3/printf.3
index 256f3b20e6..bcf152fd8c 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -155,13 +155,17 @@ the position in the argument list of the desired argument, indexed starting
from 1. Thus,
.RS
.nf
- printf("%*d", width, num);
+
+ printf("%*d", width, num);
+
.fi
.RE
and
.RS
.nf
- printf("%2$*1$d", width, num);
+
+ printf("%2$*1$d", width, num);
+
.fi
.RE
are equivalent. The second style allows repeated references to the
@@ -181,7 +185,7 @@ uses `.' as radix character, and does not have a grouping character.
Thus,
.RS
.nf
- printf("%'.2f", 1234567.89);
+ printf("%'.2f", 1234567.89);
.fi
.RE
results in `1234567.89' in the POSIX locale, in `1234567,89' in the
@@ -711,6 +715,7 @@ specification is `%%'.
To print \*(Pi to five decimal places:
.RS
.nf
+
#include <math.h>
#include <stdio.h>
fprintf(stdout, "pi = %.5f\en", 4 * atan(1.0));
@@ -725,9 +730,10 @@ and
are pointers to strings:
.RS
.nf
+
#include <stdio.h>
fprintf(stdout, "%s, %s %d, %.2d:%.2d\en",
- weekday, month, day, hour, min);
+ weekday, month, day, hour, min);
.fi
.RE
.PP
@@ -736,9 +742,11 @@ Hence, an internationalized version must be able to print
the arguments in an order specified by the format:
.RS
.nf
+
#include <stdio.h>
fprintf(stdout, format,
- weekday, month, day, hour, min);
+ weekday, month, day, hour, min);
+
.fi
.RE
where
@@ -755,40 +763,42 @@ To allocate a sufficiently large string and print into it
(code correct for both glibc 2.0 and glibc 2.1):
.RS
.nf
+
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
char *
-make_message(const char *fmt, ...) {
- /* Guess we need no more than 100 bytes. */
- int n, size = 100;
- char *p, *np;
- va_list ap;
+make_message(const char *fmt, ...)
+{
+ /* Guess we need no more than 100 bytes. */
+ int n, size = 100;
+ char *p, *np;
+ va_list ap;
- if ((p = malloc(size)) == NULL)
- return NULL;
+ if ((p = malloc(size)) == NULL)
+ return NULL;
- while (1) {
- /* Try to print in the allocated space. */
- va_start(ap, fmt);
- n = vsnprintf(p, size, fmt, ap);
- va_end(ap);
- /* If that worked, return the string. */
- if (n > \-1 && n < size)
- return p;
- /* Else try again with more space. */
- if (n > \-1) /* glibc 2.1 */
- size = n+1; /* precisely what is needed */
- else /* glibc 2.0 */
- size *= 2; /* twice the old size */
- if ((np = realloc (p, size)) == NULL) {
- free(p);
- return NULL;
- } else {
- p = np;
- }
- }
+ while (1) {
+ /* Try to print in the allocated space. */
+ va_start(ap, fmt);
+ n = vsnprintf(p, size, fmt, ap);
+ va_end(ap);
+ /* If that worked, return the string. */
+ if (n > \-1 && n < size)
+ return p;
+ /* Else try again with more space. */
+ if (n > \-1) /* glibc 2.1 */
+ size = n+1; /* precisely what is needed */
+ else /* glibc 2.0 */
+ size *= 2; /* twice the old size */
+ if ((np = realloc (p, size)) == NULL) {
+ free(p);
+ return NULL;
+ } else {
+ p = np;
+ }
+ }
}
.fi
.RE
diff --git a/man3/sockatmark.3 b/man3/sockatmark.3
index 0ec8646482..2f95c3b73f 100644
--- a/man3/sockatmark.3
+++ b/man3/sockatmark.3
@@ -93,7 +93,7 @@ and then read the byte of data at the mark:
perror("sockatmark");
break;
}
-
+
if (atmark)
break;
diff --git a/man3/stdarg.3 b/man3/stdarg.3
index 9560b272e5..dd56df80a4 100644
--- a/man3/stdarg.3
+++ b/man3/stdarg.3
@@ -154,15 +154,15 @@ In such a setup (by far the most common) there seems
nothing against an assignment
.RS
.nf
- va_list aq = ap;
+ va_list aq = ap;
.fi
.RE
Unfortunately, there are also systems that make it an
array of pointers (of length 1), and there one needs
.RS
.nf
- va_list aq;
- *aq = *ap;
+ va_list aq;
+ *aq = *ap;
.fi
.RE
Finally, on systems where parameters are passed in registers,
@@ -179,10 +179,10 @@ To accommodate this situation, C99 adds a macro
so that the above assignment can be replaced by
.RS
.nf
- va_list aq;
- va_copy(aq, ap);
- ...
- va_end(aq);
+ va_list aq;
+ va_copy(aq, ap);
+ ...
+ va_end(aq);
.fi
.RE
Each invocation of
@@ -205,30 +205,32 @@ with each format character based on the type.
#include <stdio.h>
#include <stdarg.h>
-void foo(char *fmt, ...) {
- va_list ap;
- int d;
- char c, *s;
+void
+foo(char *fmt, ...)
+{
+ va_list ap;
+ int d;
+ char c, *s;
- va_start(ap, fmt);
- while (*fmt)
- switch(*fmt++) {
- case 's': /* string */
- s = va_arg(ap, char *);
- printf("string %s\en", s);
- break;
- case 'd': /* int */
- d = va_arg(ap, int);
- printf("int %d\en", d);
- break;
- case 'c': /* char */
- /* need a cast here since va_arg only
- takes fully promoted types */
- c = (char) va_arg(ap, int);
- printf("char %c\en", c);
- break;
- }
- va_end(ap);
+ va_start(ap, fmt);
+ while (*fmt)
+ switch(*fmt++) {
+ case 's': /* string */
+ s = va_arg(ap, char *);
+ printf("string %s\en", s);
+ break;
+ case 'd': /* int */
+ d = va_arg(ap, int);
+ printf("int %d\en", d);
+ break;
+ case 'c': /* char */
+ /* need a cast here since va_arg only
+ takes fully promoted types */
+ c = (char) va_arg(ap, int);
+ printf("char %c\en", c);
+ break;
+ }
+ va_end(ap);
}
.fi
.RE
@@ -254,16 +256,19 @@ The historic setup is:
.nf
#include <varargs.h>
-void foo(va_alist) va_dcl {
- va_list ap;
+void
+foo(va_alist)
+ va_dcl
+{
+ va_list ap;
- va_start(ap);
- while(...) {
- ...
- x = va_arg(ap, type);
- ...
- }
- va_end(ap);
+ va_start(ap);
+ while(...) {
+ ...
+ x = va_arg(ap, type);
+ ...
+ }
+ va_end(ap);
}
.fi
.RE
diff --git a/man3/strftime.3 b/man3/strftime.3
index c10445ddd0..e3965e4b3a 100644
--- a/man3/strftime.3
+++ b/man3/strftime.3
@@ -310,14 +310,17 @@ Of course programmers are encouraged to use %c, it gives the preferred
date and time representation. One meets all kinds of strange obfuscations
to circumvent this gcc problem. A relatively clean one is to add an
intermediate function
-.RS
-size_t my_strftime(char *s, size_t max, const char *fmt,
-const struct tm *tm) {
-.br
- return strftime(s, max, fmt, tm);
-.br
+.in +0.5i
+.nf
+
+size_t
+my_strftime(char *s, size_t max, const char *fmt,
+ const struct tm *tm)
+{
+ return strftime(s, max, fmt, tm);
}
-.RE
+.fi
+.in -0.5i
.SH EXAMPLE
The program below can be used to experiment with
.BR strftime ().
diff --git a/man3/termios.3 b/man3/termios.3
index fe6546f602..6a5204cc5f 100644
--- a/man3/termios.3
+++ b/man3/termios.3
@@ -666,7 +666,7 @@ until \fBtcsetattr\fP() is successfully called.
Setting the speed to \fBB0\fP instructs the modem to "hang up".
The actual bit rate corresponding to \fBB38400\fP may be altered with
-\fBsetserial\fP(8).
+\fBsetserial\fP(8).
.LP
The input and output baud rates are stored in the \fItermios\fP
structure.
generated by cgit 1.2.3-korg (git 2.43.0) at 2025-11-30 17:42:28 +0000