From owner-freebsd-doc@FreeBSD.ORG  Fri Jul 18 12:30:04 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 19677106567F
	for <freebsd-doc@hub.freebsd.org>; Fri, 18 Jul 2008 12:30:04 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id DA5BA8FC23
	for <freebsd-doc@hub.freebsd.org>; Fri, 18 Jul 2008 12:30:03 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m6ICU3oI052617
	for <freebsd-doc@freefall.freebsd.org>; Fri, 18 Jul 2008 12:30:03 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m6ICU3SF052614;
	Fri, 18 Jul 2008 12:30:03 GMT (envelope-from gnats)
Resent-Date: Fri, 18 Jul 2008 12:30:03 GMT
Resent-Message-Id: <200807181230.m6ICU3SF052614@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-doc@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Dan Lukes <dan@obluda.cz>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CA3EE1065674
	for <FreeBSD-gnats-submit@freebsd.org>;
	Fri, 18 Jul 2008 12:24:27 +0000 (UTC)
	(envelope-from dan@kulesh.obluda.cz)
Received: from kulesh.obluda.cz (kulesh.obluda.cz [193.179.199.51])
	by mx1.freebsd.org (Postfix) with ESMTP id 41DBA8FC0A
	for <FreeBSD-gnats-submit@freebsd.org>;
	Fri, 18 Jul 2008 12:24:26 +0000 (UTC)
	(envelope-from dan@kulesh.obluda.cz)
Received: from kulesh.obluda.cz (localhost. [127.0.0.1])
	by kulesh.obluda.cz (8.14.2/8.14.2) with ESMTP id m6ICOOil024842
	for <FreeBSD-gnats-submit@freebsd.org>;
	Fri, 18 Jul 2008 14:24:24 +0200 (CEST)
	(envelope-from dan@kulesh.obluda.cz)
Received: (from root@localhost)
	by kulesh.obluda.cz (8.14.2/8.14.2/Submit) id m6ICONV2024841;
	Fri, 18 Jul 2008 14:24:23 +0200 (CEST) (envelope-from dan)
Message-Id: <200807181224.m6ICONV2024841@kulesh.obluda.cz>
Date: Fri, 18 Jul 2008 14:24:23 +0200 (CEST)
From: Dan Lukes <dan@obluda.cz>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Cc: 
Subject: docs/125746: man 2 socket ERRORS section incomplete
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Dan Lukes <dan@obluda.cz>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 18 Jul 2008 12:30:04 -0000


>Number:         125746
>Category:       docs
>Synopsis:       man 2 socket ERRORS section incomplete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 18 12:30:03 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Dan Lukes
>Release:        FreeBSD 6.3-STABLE i386
>Organization:
Obludarium
>Environment:
src/lib/libc/sys/socket.2,v 1.30 2004/07/02 23:52:13 ru

>Description:
	socket(2) may return EPERM also, for example, when SOCK_RAW socket type requested by non-superuser

	The EPERM return code is not mentioned in ERRORS section of manual page


>How-To-Repeat:
>Fix:

	Add the notice about the EPERM in ERROR section of socket(2) manual page - something like:

EPERM  User has insufficient privileges to carry out requested operation.

>Release-Note:
>Audit-Trail:
>Unformatted: