LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / tee.2

diff --git a/original/man2/tee.2 b/original/man2/tee.2
index 2f13ecc..ac7f386 100644 (file)
--- a/original/man2/tee.2
+++ b/original/man2/tee.2
@@ -1,8 +1,7 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" This manpage is Copyright (C) 2006 Jens Axboe
 .\" and Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" 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.
@@ -22,8 +21,9 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH TEE 2 2009-09-15 "Linux" "Linux Programmer's Manual"
+.TH TEE 2 2014-12-31 "Linux" "Linux Programmer's Manual"
 .SH NAME
 tee \- duplicating pipe content
 .SH SYNOPSIS
@@ -99,6 +99,12 @@ returns \-1 and
 is set to indicate the error.
 .SH ERRORS
 .TP
+.B EAGAIN
+.B SPLICE_F_NONBLOCK
+was specified in
+.IR flags ,
+and the operation would block.
+.TP
 .B EINVAL
 .I fd_in
 or
@@ -114,8 +120,9 @@ Out of memory.
 .SH VERSIONS
 The
 .BR tee ()
-system call first appeared in Linux 2.6.17.
-.SH "CONFORMING TO"
+system call first appeared in Linux 2.6.17;
+library support was added to glibc in version 2.5.
+.SH CONFORMING TO
 This system call is Linux-specific.
 .SH NOTES
 Conceptually,
@@ -127,11 +134,22 @@ under the covers,
 assigns data in the output by merely grabbing
 a reference to the input.
 .SH EXAMPLE
-The following example implements a basic
+The example below implements a basic
 .BR tee (1)
 program using the
 .BR tee ()
 system call.
+Here is an example of its use:
+
+.in +4n
+.nf
+$ \fBdate |./a.out out.log | cat\fP
+Tue Oct 28 10:06:00 CET 2014
+$ \fBcat out.log\fP
+Tue Oct 28 10:06:00 CET 2014
+.fi
+.in
+.SS Program source
 .nf
 
 #define _GNU_SOURCE
@@ -196,3 +214,12 @@ main(int argc, char *argv[])
 .SH SEE ALSO
 .BR splice (2),
 .BR vmsplice (2)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.