[illumos-gate merge]

commit cd62a92d4a964bfe61d35ba2301b69e65e22a509
    7092 Want support for stdio memory streams
    12360 fwrite can loop forever on zero byte write
    12392 ftello64 doesn't handle ungetc() correctly when unbuffered
commit 1470234269f4edea4cbf270cb2475e4988b788d5
    12359 Want a means to set the umem mtbf at runtine
commit 0ac311bae7f6f50d9ba506b52bd8860f2d68d4ce
    12358 Need mbrtowc variant that indicates consumed zero bytes
commit d726994754c938f91b6fd7e96b5cab3829615c58
    12357 getc/putc_unlocked need to set orientation

1 files changed, 4 insertions, 10 deletions

diff --git a/usr/src/man/man3c/fputc.3c b/usr/src/man/man3c/fputc.3c
index 11f4d8f711..2cd811282d 100644
--- a/usr/src/man/man3c/fputc.3c
+++ b/usr/src/man/man3c/fputc.3c
@@ -43,12 +43,11 @@
 .\" Portions Copyright (c) 1992, X/Open Company Limited.  All Rights Reserved.
 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved.
 .\"
-.TH FPUTC 3C "May 13, 2017"
+.TH FPUTC 3C "March 25, 2020"
 .SH NAME
 fputc, putc, putc_unlocked, putchar, putchar_unlocked, putw \- put a byte on a
 stream
 .SH SYNOPSIS
-.LP
 .nf
 #include <stdio.h>
 
@@ -81,7 +80,6 @@ stream
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBfputc()\fR function writes the byte specified by \fIc\fR (converted to
 an \fBunsigned char\fR) to the output stream pointed to by \fIstream\fR, at the
 position indicated by the associated file-position indicator for the stream (if
@@ -125,7 +123,6 @@ update between the successful execution of \fBputw()\fR and the next successful
 completion of a call to \fBfflush\fR(3C) or \fBfclose\fR(3C) on the same stream
 or a call to \fBexit\fR(3C) or \fBabort\fR(3C).
 .SH RETURN VALUES
-.LP
 Upon successful completion, \fBfputc()\fR, \fBputc()\fR, \fBputc_unlocked()\fR,
 \fBputchar()\fR, and \fBputchar_unlocked()\fR return the value that was
 written.  Otherwise, these functions return EOF, the error indicator for the
@@ -140,7 +137,6 @@ sets \fBerrno\fR to indicate the error.
 An unsuccessful completion will occur, for example, if the file associated with
 \fIstream\fR is not open for writing or if the output file cannot grow.
 .SH ERRORS
-.LP
 The \fBfputc()\fR, \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR,
 \fBputchar_unlocked()\fR, and \fBputw()\fR functions will fail if either the
 \fIstream\fR is unbuffered or the \fIstream\fR's buffer needs to be flushed,
@@ -204,7 +200,9 @@ was transferred.
 A physical I/O error has occurred, or the process is a member of a background
 process group attempting to write to its controlling terminal, \fBTOSTOP\fR is
 set, the process is neither ignoring nor blocking \fBSIGTTOU\fR and the process
-group of the process is orphaned. This error may also be returned under
+group of the process is orphaned.  \fIstream\fR was created by
+\fBopen_wmemstream\fR(3C) and a wide-character or byte sequence buffered is
+invalid in the current locale.  This error may also be returned under
 implementation-dependent conditions.
 .RE
 
@@ -252,7 +250,6 @@ capabilities of the device.
 .RE
 
 .SH USAGE
-.LP
 Functions exist for the \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR,
 and \fBputchar_unlocked()\fR macros. To get the function form, the macro name
 must be undefined (for example, \fB#undef putc\fR).
@@ -276,7 +273,6 @@ in the context of either multibyte character streams or wide-character streams.
 Application programmers are encouraged to use one of the character-based output
 functions instead.
 .SH ATTRIBUTES
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
@@ -295,14 +291,12 @@ MT-Level	See \fBNOTES\fR below.
 .TE
 
 .SH SEE ALSO
-.LP
 \fBgetrlimit\fR(2), \fBulimit\fR(2) \fBwrite\fR(2), \fBIntro\fR(3),
 \fBabort\fR(3C), \fBexit\fR(3C), \fBfclose\fR(3C), \fBferror\fR(3C),
 \fBfflush\fR(3C), \fBflockfile\fR(3C), \fBprintf\fR(3C),
 \fBputc\fR(3C), \fBputs\fR(3C), \fBsetbuf\fR(3C), \fBstdio\fR(3C),
 \fBattributes\fR(5), \fBstandards\fR(5)
 .SH NOTES
-.LP
 The \fBfputc()\fR, \fBputc()\fR, \fBputchar()\fR, and \fBputw()\fR routines are
 MT-Safe in multithreaded applications.  The \fBputc_unlocked()\fR and
 \fBputchar_unlocked()\fR routines are unsafe in multithreaded applications.