4493 want siginfo

4494 Make dd show progress when you send INFO/USR1 signals
4495 dd could support O_SYNC and O_DSYNC
Reviewed by: Jerry Jelinek <jerry.jelinek@joyent.com>
Reviewed by: Joshua M. Clulow <josh@sysmgr.org>
Reviewed by: Richard Lowe <richlowe@richlowe.net>
Reviewed by: Garrett D'Amore <garrett@damore.org>
Approved by: Garrett D'Amore <garrett@damore.org>

5 files changed, 86 insertions, 26 deletions

diff --git a/usr/src/man/man1/stty.1 b/usr/src/man/man1/stty.1
index e3cb5c7d70..21e44cae64 100644
--- a/usr/src/man/man1/stty.1
+++ b/usr/src/man/man1/stty.1
@@ -1,6 +1,7 @@
 '\" te
 .\" Copyright 1989 AT&T
 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
+.\" Copyright (c) 2014, Joyent, Inc. All Rights Reserved
 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at  http://www.opengroup.org/bookstore/.
 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
@@ -10,7 +11,7 @@
 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
 .\"  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with
 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH STTY 1 "May 20, 2009"
+.TH STTY 1 "Jan 04, 2014"
 .SH NAME
 stty \- set the options for a terminal
 .SH SYNOPSIS
@@ -956,9 +957,9 @@ Set \fIcontrol-character\fR to \fIc\fR, where:
 .RS 21n
 is \fBctab\fR, \fBdiscard\fR, \fBdsusp\fR, \fBeof\fR, \fBeol\fR, \fBeol2\fR,
 \fBerase\fR, \fBintr\fR, \fBkill\fR, \fBlnext\fR, \fBquit\fR, \fBreprint\fR,
-\fBstart\fR, \fBstop\fR, \fBsusp\fR, \fBswtch\fR, or \fBwerase\fR (\fBctab\fR
-is used with \fB-stappl\fR, see \fBtermio\fR(7I)). For information on
-\fBswtch\fR, see NOTES.
+\fBstart\fR, \fBstop\fR, \fBsusp\fR, \fBstatus\fR, \fBswtch\fR, or \fBwerase\fR
+(\fBctab\fR is used with \fB-stappl\fR, see \fBtermio\fR(7I)). For information
+on \fBswtch\fR, see NOTES.
 .RE
 
 .sp
diff --git a/usr/src/man/man1m/dd.1m b/usr/src/man/man1m/dd.1m
index ffdedba12f..99dae520ff 100644
--- a/usr/src/man/man1m/dd.1m
+++ b/usr/src/man/man1m/dd.1m
@@ -1,4 +1,5 @@
 '\" te
+.\" Copyright (c) 2014, Joyent, Inc.  All rights Reserved.
 .\" Copyright (c) 1992, X/Open Company Limited  All Rights Reserved
 .\" Copyright 1989 AT&T
 .\" Portions Copyright (c) 1995, Sun Microsystems, Inc.  All Rights Reserved
@@ -9,7 +10,7 @@
 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH DD 1M "Sep 16, 1996"
+.TH DD 1M "Jan 04, 2014"
 .SH NAME
 dd \- convert and copy a file
 .SH SYNOPSIS
@@ -381,9 +382,40 @@ bytes. (If either \fBblock\fR or \fBunblock\fR is also specified, appends
 .RE
 
 .sp
+.ne 2
+.na
+\fB\fBoflag=\fR\fIvalue\fR[\fB,\fR\fIvalue\fR.\|.\|.\|]\fR
+.ad
+.sp .6
+Where \fIvalue\fRs are comma-separated symbols from the following list which
+affect the behavior of writing the output file:
+.sp
+.ne 2
+.na
+\fB\fBdsync\fR\fR
+.ad
+.RS 11n
+The output file is opened with the \fBO_DSYNC\fR flag set. All data writes will
+be synchronous. For more information on \fBO_DSYNC\fR see \fBfcntl.h\fR(3HEAD).
+.RE
+
+.sp
+.ne 2
+.na
+\fB\fBsync\fR\fR
+.ad
+.RS 11n
+The output file is opened with the \fBO_SYNC\fR flag set. All data and metadata
+writes will be synchronous. For more information on \fBO_SYNC\fR see
+\fBfcntl.h\fR(3HEAD).
+.RE
+
+.RE
+
+.sp
 .LP
-If operands other than \fBconv=\fR are specified more than once, the last
-specified \fBoperand=\fR\fIvalue\fR is used.
+If operands other than \fBconv=\fR and \fBoflag=\fR are specified more than once,
+the last specified \fBoperand=\fR\fIvalue\fR is used.
 .sp
 .LP
 For the \fBbs=\fR, \fBcbs=\fR, \fBibs=\fR, and \fBobs=\fR operands, the
@@ -451,6 +483,20 @@ separated by \fBx\fR, specifying the product of the indicated values.
 .sp
 .LP
 All of the operands will be processed before any input is read.
+.SH SIGNALS
+.sp
+.LP
+When \fBdd\fR receives either SIGINFO or SIGUSR1, \fBdd\fR will emit the current
+input and output block counts, total bytes written, total time elapsed, and the
+number of bytes per second to standard error. This is the same information
+format that \fBdd\fR emits when it successfully completes. Users may send
+SIGINFO via their terminal. The default character is ^T, see \fBstty\fR(1) for
+more information.
+.sp
+.LP
+For \fBSIGINT\fR, \fBdd\fR writes status information to standard error before
+exiting. \fBdd\fR takes the standard action for all other signals.
+
 .SH USAGE
 .sp
 .LP
@@ -569,8 +615,8 @@ Interface Stability	Standard
 .SH SEE ALSO
 .sp
 .LP
-\fBcp\fR(1), \fBsed\fR(1), \fBtr\fR(1), \fBattributes\fR(5), \fBenviron\fR(5),
-\fBlargefile\fR(5), \fBstandards\fR(5)
+\fBcp\fR(1), \fBsed\fR(1), \fBtr\fR(1), \fBfcntl.h\fR(3HEAD),
+\fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
 .SH DIAGNOSTICS
 .sp
 .ne 2
@@ -601,7 +647,3 @@ from the pipe at the time.
 When using \fBdd\fR to copy files to a tape device, the file size must be a
 multiple of the device sector size (for example, 512 Kbyte).  To  copy files of
 arbitrary size to a tape device, use  \fBtar\fR(1) or  \fBcpio\fR(1).
-.sp
-.LP
-For \fBSIGINT\fR, \fBdd\fR writes status information to standard error before
-exiting. It takes the standard action for all other signals.
diff --git a/usr/src/man/man3head/signal.h.3head b/usr/src/man/man3head/signal.h.3head
index e1974ce1eb..0d213e8fd7 100644
--- a/usr/src/man/man3head/signal.h.3head
+++ b/usr/src/man/man3head/signal.h.3head
@@ -8,7 +8,7 @@
 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH SIGNAL.H 3HEAD "Feb 5, 2008"
+.TH SIGNAL.H 3HEAD "Jan 4, 2014"
 .SH NAME
 signal.h, signal \- base signals
 .SH SYNOPSIS
@@ -174,6 +174,7 @@ Resource control exceeded (see \fBsetrctl\fR(2))
 T}
 \fBSIGJVM1\fR	39	Ignore	Reserved for Java Virtual Machine 1
 \fBSIGJVM2\fR	40	Ignore	Reserved for Java Virtual Machine 2
+\fBSIGINFO\fR	41	Ignore	Status request
 \fBSIGRTMIN\fR	\fB*\fR	Exit	First real time signal
 (\fBSIGRTMIN\fR+1)	*	Exit	Second real time signal
 \fB\|.\|.\|.\fR			
diff --git a/usr/src/man/man3head/termios.h.3head b/usr/src/man/man3head/termios.h.3head
index 7b2f4f058e..cb29f860ac 100644
--- a/usr/src/man/man3head/termios.h.3head
+++ b/usr/src/man/man3head/termios.h.3head
@@ -7,7 +7,7 @@
 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH TERMIOS.H 3HEAD "Sep 10, 2004"
+.TH TERMIOS.H 3HEAD "Jan 04, 2014"
 .SH NAME
 termios.h, termios \- define values for termios
 .SH SYNOPSIS
@@ -110,6 +110,7 @@ _
 \fBVSTOP\fR	\fBVSTOP\fR	STOP character
 \fBVSUSP\fR	\fBVSUSP\fR	SUSP character
 	\fBVTIME\fR	TIME value
+\fBVSTATUS\fR		STATUS character
 .TE
 
 .sp
diff --git a/usr/src/man/man7i/termio.7i b/usr/src/man/man7i/termio.7i
index 8921aa67c0..71c78d0e96 100644
--- a/usr/src/man/man7i/termio.7i
+++ b/usr/src/man/man7i/termio.7i
@@ -1,5 +1,6 @@
 '\" te
 .\" Copyright (c) 2005, Sun Microsystems, Inc.  All Rights Reserved.
+.\" Copyright (c) 2014, Joyent, Inc.  All Rights Reserved.
 .\" Copyright 1989 AT&T
 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
@@ -456,6 +457,18 @@ arrives, or the condition is cleared by a program.
 .sp
 .ne 2
 .na
+\fB\fBSTATUS\fR\fR
+.ad
+.RS 11n
+(Control-t or \fBASCII DC4\fR) generates a \fBSIGINFO\fR signal. Processes with
+a handler will output status information when they receive \fBSIGINFO\fR, for
+example, \fBdd(1)\fR. If a process does not have a \fBSIGINFO\fR handler, the
+signal will be ignored.
+.RE
+
+.sp
+.ne 2
+.na
 \fB\fBLNEXT\fR\fR
 .ad
 .RS 11n
@@ -465,13 +478,13 @@ allows characters to be input that would otherwise be interpreted by the system
 (for example \fBKILL, QUIT\fR).  The character values for \fBINTR\fR,
 \fBQUIT\fR, \fBERASE\fR, \fBWERASE\fR, \fBKILL\fR, \fBREPRINT\fR, \fBEOF\fR,
 \fBEOL\fR, \fBEOL2\fR, \fBSWTCH\fR, \fBSUSP\fR, \fBDSUSP\fR, \fBSTOP\fR,
-\fBSTART\fR, \fBDISCARD\fR, and \fBLNEXT\fR may be changed to suit individual
-tastes. If the value of a special control character is _POSIX_VDISABLE (0), the
-function of that special control character is disabled. The \fBERASE\fR,
-\fBKILL\fR, and \fBEOF\fR characters may be escaped by a preceding backslash
-(\e) character, in which case no special function is done. Any of the special
-characters may be preceded by the \fBLNEXT\fR character, in which case no
-special function is done.
+\fBSTART\fR, \fBDISCARD\fR, \fBSTATUS\fR, and \fBLNEXT\fR may be changed to suit
+individual tastes. If the value of a special control character is
+_POSIX_VDISABLE (0), the function of that special control character is disabled.
+The \fBERASE\fR, \fBKILL\fR, and \fBEOF\fR characters may be escaped by a
+preceding backslash (\e) character, in which case no special function is done.
+Any of the special characters may be preceded by the \fBLNEXT\fR character, in
+which case no special function is done.
 .RE
 
 .SS "Modem Disconnect"
@@ -565,7 +578,9 @@ _
 _
 15	VLNEXT	SYN
 _
-16-19	Reserved	
+16	VSTATUS	DC4
+_
+17-19	Reserved	
 .TE
 
 .SS "Input Modes"
@@ -1856,9 +1871,9 @@ with code 177 octal, is echoed as ^ \fB?\fR.
 .sp
 .LP
 If  \fBNOFLSH\fR is set, the normal flush of the input and output queues
-associated with the \fBINTR\fR, \fBQUIT\fR, and \fBSUSP\fR characters is not
-done.  This bit should be set when restarting system calls that read from or
-write to a terminal (see  \fBsigaction\fR(2)\|).
+associated with the \fBINTR\fR, \fBQUIT\fR, \fBSTATUS\fR, and \fBSUSP\fR
+characters is not done.  This bit should be set when restarting system calls
+that read from or write to a terminal (see  \fBsigaction\fR(2)\|).
 .sp
 .LP
 If  \fBTOSTOP\fR and \fBIEXTEN\fR are set, the signal  \fBSIGTTOU\fR is sent to