From owner-freebsd-doc@FreeBSD.ORG Mon Aug 11 10:40:02 2008 Return-Path: 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 5092D106568D for ; Mon, 11 Aug 2008 10:40:02 +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 2D2928FC22 for ; Mon, 11 Aug 2008 10:40:02 +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 m7BAe2Wo045284 for ; Mon, 11 Aug 2008 10:40:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m7BAe25x045283; Mon, 11 Aug 2008 10:40:02 GMT (envelope-from gnats) Resent-Date: Mon, 11 Aug 2008 10:40:02 GMT Resent-Message-Id: <200808111040.m7BAe25x045283@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, "Ronald F.Guilmette" Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 47BDD106566C for ; Mon, 11 Aug 2008 10:32:51 +0000 (UTC) (envelope-from rfg@tristatelogic.com) Received: from segfault-outgoing-helo.tristatelogic.com (112.171-60-66-fuji-dsl.static.surewest.net [66.60.171.112]) by mx1.freebsd.org (Postfix) with ESMTP id 2C4358FC0A for ; Mon, 11 Aug 2008 10:32:51 +0000 (UTC) (envelope-from rfg@tristatelogic.com) Received: by segfault.tristatelogic.com (Postfix, from userid 1237) id B2765BDC53; Mon, 11 Aug 2008 03:32:50 -0700 (PDT) Message-Id: <20080811103250.B2765BDC53@segfault.tristatelogic.com> Date: Mon, 11 Aug 2008 03:32:50 -0700 (PDT) From: "Ronald F.Guilmette" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/126451: Exit status of nc(1) is not documented X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: "Ronald F.Guilmette" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Aug 2008 10:40:02 -0000 >Number: 126451 >Category: docs >Synopsis: Exit status of nc(1) is not documented >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: Mon Aug 11 10:40:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Ronald F. Guilmette >Release: FreeBSD 7.0-RELEASE i386 >Organization: Infinite Monkeys & Co. LLC >Environment: System: FreeBSD 7.0-RELEASE >Description: The man page for nc(1) fails to document the possible exit stati of the program. >How-To-Repeat: man 1 nc >Fix: Add an EXIT STATUS section to the man page for nc(1). The exit status seems to be 0 if all goes well, or else 1 if any of the following errors occurs: (a) hostname given on the command line does not resolve or (b) connection is refused by the remote host or (c) connection to remote host times out before connection is established or (d) -l option used with privledged portno (<1024) when nc is executed by an unprivledged user or (e) -l option used, but hostname does not correspond to any IP address associated with any local IP interface. There are probably man other conditions that could be associated with a non-zero exit status. Ideally, they should all be listed in the man page. >Release-Note: >Audit-Trail: >Unformatted: