Bug 167201

Summary: manpage pread(2) misses one error case (EBUSY)
Product: Documentation Reporter: Kurt Jaeger <fbsd-ports>
Component: Books & ArticlesAssignee: Eitan Adler <eadler>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Kurt Jaeger 2012-04-22 14:00:27 UTC
	a call to pread might fail with EBUSY in certain cases,
	and that error is not in the man page.

How-To-Repeat: 	ports/devel/strace uses pread and fails because of this
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2012-04-22 14:28:13 UTC
Responsible Changed
From-To: freebsd-doc->eadler

I'll take it.
Comment 2 Eitan Adler freebsd_committer freebsd_triage 2012-04-22 15:29:10 UTC
State Changed
From-To: open->analyzed

awaiting approval
Comment 3 dfilter service freebsd_committer freebsd_triage 2012-04-29 23:23:14 UTC
Author: eadler
Date: Sun Apr 29 22:23:00 2012
New Revision: 234820
URL: http://svn.freebsd.org/changeset/base/234820

Log:
  pread(2) might fail with EBUSY, so document it
  
  PR:		docs/167201
  Submitted by:	Kurt Jaeger <fbsd-ports@opsec.eu>
  Approved by:	cperciva
  MFC after:	3 days

Modified:
  head/lib/libc/sys/read.2

Modified: head/lib/libc/sys/read.2
==============================================================================
--- head/lib/libc/sys/read.2	Sun Apr 29 22:19:58 2012	(r234819)
+++ head/lib/libc/sys/read.2	Sun Apr 29 22:23:00 2012	(r234820)
@@ -164,6 +164,8 @@ argument
 points outside the allocated address space.
 .It Bq Er EIO
 An I/O error occurred while reading from the file system.
+.It Bq Er EBUSY
+Failed to read from a file, e.g. /proc/<pid>/regs while <pid> is not stopped
 .It Bq Er EINTR
 A read from a slow device
 (i.e.\& one that might block for an arbitrary amount of time)
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 4 Eitan Adler freebsd_committer freebsd_triage 2012-04-29 23:32:27 UTC
State Changed
From-To: analyzed->patched

committed in r234820
Comment 5 dfilter service freebsd_committer freebsd_triage 2012-05-06 15:22:50 UTC
Author: eadler
Date: Sun May  6 14:22:30 2012
New Revision: 235088
URL: http://svn.freebsd.org/changeset/base/235088

Log:
  MFC r234820:
  	 pread(2) might fail with EBUSY, so document it
  
  PR:		docs/167201
  Approved by:	cperciva (implicit)

Modified:
  stable/9/lib/libc/sys/read.2
Directory Properties:
  stable/9/lib/libc/   (props changed)
  stable/9/lib/libc/sys/   (props changed)

Modified: stable/9/lib/libc/sys/read.2
==============================================================================
--- stable/9/lib/libc/sys/read.2	Sun May  6 14:16:18 2012	(r235087)
+++ stable/9/lib/libc/sys/read.2	Sun May  6 14:22:30 2012	(r235088)
@@ -164,6 +164,8 @@ argument
 points outside the allocated address space.
 .It Bq Er EIO
 An I/O error occurred while reading from the file system.
+.It Bq Er EBUSY
+Failed to read from a file, e.g. /proc/<pid>/regs while <pid> is not stopped
 .It Bq Er EINTR
 A read from a slow device
 (i.e.\& one that might block for an arbitrary amount of time)
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 6 dfilter service freebsd_committer freebsd_triage 2012-05-06 15:23:15 UTC
Author: eadler
Date: Sun May  6 14:23:01 2012
New Revision: 235089
URL: http://svn.freebsd.org/changeset/base/235089

Log:
  MFC r234820:
  	 pread(2) might fail with EBUSY, so document it
  
  PR:		docs/167201
  Approved by:	cperciva (implicit)

Modified:
  stable/8/lib/libc/sys/read.2
Directory Properties:
  stable/8/lib/libc/   (props changed)
  stable/8/lib/libc/sys/   (props changed)

Modified: stable/8/lib/libc/sys/read.2
==============================================================================
--- stable/8/lib/libc/sys/read.2	Sun May  6 14:22:30 2012	(r235088)
+++ stable/8/lib/libc/sys/read.2	Sun May  6 14:23:01 2012	(r235089)
@@ -164,6 +164,8 @@ argument
 points outside the allocated address space.
 .It Bq Er EIO
 An I/O error occurred while reading from the file system.
+.It Bq Er EBUSY
+Failed to read from a file, e.g. /proc/<pid>/regs while <pid> is not stopped
 .It Bq Er EINTR
 A read from a slow device
 (i.e.\& one that might block for an arbitrary amount of time)
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 7 dfilter service freebsd_committer freebsd_triage 2012-05-06 15:23:30 UTC
Author: eadler
Date: Sun May  6 14:23:19 2012
New Revision: 235090
URL: http://svn.freebsd.org/changeset/base/235090

Log:
  MFC r234820:
  	 pread(2) might fail with EBUSY, so document it
  
  PR:		docs/167201
  Approved by:	cperciva (implicit)

Modified:
  stable/7/lib/libc/sys/read.2
Directory Properties:
  stable/7/lib/libc/   (props changed)

Modified: stable/7/lib/libc/sys/read.2
==============================================================================
--- stable/7/lib/libc/sys/read.2	Sun May  6 14:23:01 2012	(r235089)
+++ stable/7/lib/libc/sys/read.2	Sun May  6 14:23:19 2012	(r235090)
@@ -164,6 +164,8 @@ argument
 points outside the allocated address space.
 .It Bq Er EIO
 An I/O error occurred while reading from the file system.
+.It Bq Er EBUSY
+Failed to read from a file, e.g. /proc/<pid>/regs while <pid> is not stopped
 .It Bq Er EINTR
 A read from a slow device
 (i.e.\& one that might block for an arbitrary amount of time)
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 8 Eitan Adler freebsd_committer freebsd_triage 2012-06-05 06:16:49 UTC
State Changed
From-To: patched->closed

Committed. Thanks!