LDP: Update original to LDP v3.79

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

diff --git a/original/man2/bdflush.2 b/original/man2/bdflush.2
index d05efe1..cc84cd2 100644 (file)
--- a/original/man2/bdflush.2
+++ b/original/man2/bdflush.2
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
@@ -18,14 +17,14 @@
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
 .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
 .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
-.TH BDFLUSH 2 2004-06-17 "Linux" "Linux Programmer's Manual"
+.TH BDFLUSH 2 2014-08-19 "Linux" "Linux Programmer's Manual"
 .SH NAME
 bdflush \- start, flush, or tune buffer-dirty-flush daemon
 .SH SYNOPSIS
@@ -36,6 +35,17 @@ bdflush \- start, flush, or tune buffer-dirty-flush daemon
 .BI "int bdflush(int "  func ", long " data );
 .fi
 .SH DESCRIPTION
+.IR Note :
+Since Linux 2.6,
+.\" As noted in a changes in the 2.5.12 source
+this system call is deprecated and does nothing.
+It is likely to disappear altogether in a future kernel release.
+Nowadays, the task performed by
+.BR bdflush ()
+is handled by the kernel
+.I pdflush
+thread.
+
 .BR bdflush ()
 starts, flushes, or tunes the buffer-dirty-flush daemon.
 Only a privileged process (one with the
@@ -73,9 +83,9 @@ and the kernel sets tuning parameter numbered
 to that value.
 .PP
 The set of parameters, their values, and their valid ranges
-are defined in the kernel source file
+are defined in the Linux kernel source file
 .IR fs/buffer.c .
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 If
 .I func
 is negative or 0 and the daemon successfully starts,
@@ -102,12 +112,20 @@ or to write an invalid value to a parameter.
 Caller does not have the
 .B CAP_SYS_ADMIN
 capability.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 .BR bdflush ()
 is Linux-specific and should not be used in programs
 intended to be portable.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR fsync (2),
 .BR sync (2),
-.BR sync (8),
-.BR update (8)
+.BR sync (1)
+.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/.