diff options
author | Craig Small <csmall@dropbear.xyz> | 2022-08-29 18:07:43 +1000 |
---|---|---|
committer | Craig Small <csmall@dropbear.xyz> | 2022-08-29 18:07:43 +1000 |
commit | 8e889ae68214241232ad522c359236ee68417733 (patch) | |
tree | 39943fd2fbfbe8d6805184cb159d80c6e18d9408 /man/procio.3 | |
parent | 5fcf104cba0eada8aca1f871195675f1287b5a80 (diff) | |
download | procps-ng-8e889ae68214241232ad522c359236ee68417733.tar.gz |
build-sys: Rearrange the manual pages
All man pages are found in ./man
man-po -> po-man
References:
https://www.freelists.org/post/procps/Next-for-newlib,3
Signed-off-by: Craig Small <csmall@dropbear.xyz>
Diffstat (limited to 'man/procio.3')
-rw-r--r-- | man/procio.3 | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/man/procio.3 b/man/procio.3 new file mode 100644 index 0000000..5b8c218 --- /dev/null +++ b/man/procio.3 @@ -0,0 +1,80 @@ +'\" t -*- coding: UTF-8 -*- +.\" +.\" This file describes the readproc interface to the /proc filesystem +.\" +.\" Copyright 2018 Werner Fink <werner@suse.de> +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.TH PROCIO 3 "16 January 2018" "Linux Manpage" "Linux Programmer's Manual" +.SH NAME +fprocopen \- stream open functions on files below /proc/## +.SH SYNOPSIS +.B #define _GNU_SOURCE +.br +.B #include <stdio.h> +.br +.B #include <proc/procio.h> +.sp +.BI "FILE *fprocopen(const char *path, const char *mode); + +.SH DESCRIPTION + +The +.B fprocopen +function opens files below +.I /proc/## +whose name is the string to by path and associates a stream with it. +The argument +.I mode +points to a string containing one of the following sequences +.TP +.B r +Open a file below +.I /proc/## +for reading even large buffers. The stream is positioned at +the beginning of the file. +.TP +.BR w [ <del> ] +Open a file below +.I /proc/## +for writing even large buffers. The optional delimiter character +can be one of the follwoing +.BR '\ ' ,\ ',' ,\ '.' ,\ and\ ':' +where the default is the comma +.BR ',' . +This allows to split very large input lines into pieces at this +delimiter and write each of them to the opened file below +.IR /proc/## . +.TP +.B e +The underlying file descriptor will be closed if you use any +of the `exec...' functions within your code. +.PP +The internal API allows the use of stdio functions to read and write +large buffers below +.IR /proc/## . +.PP +.SH SEE ALSO +.BR fopen (3), +.br +.BR fopencookie (3) +.br +.BR setvbuf (3) +.br +.BR lseek (3) +.PP +.SH COPYRIGHT +2018 Werner Fink, +.SH AUTHOR +Werner Fink <werner@suse.de> |