From owner-freebsd-doc@FreeBSD.ORG Thu Apr 3 11:50:08 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 37ACC37B401 for ; Thu, 3 Apr 2003 11:50:08 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7094B43F3F for ; Thu, 3 Apr 2003 11:50:07 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h33Jo6Up026897 for ; Thu, 3 Apr 2003 11:50:06 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h33Jo6uC026896; Thu, 3 Apr 2003 11:50:06 -0800 (PST) Resent-Date: Thu, 3 Apr 2003 11:50:06 -0800 (PST) Resent-Message-Id: <200304031950.h33Jo6uC026896@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 [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7B5D537B404 for ; Thu, 3 Apr 2003 11:49:02 -0800 (PST) Received: from segfault.monkeys.com (segfault.monkeys.com [66.60.157.246]) by mx1.FreeBSD.org (Postfix) with ESMTP id EA63843F75 for ; Thu, 3 Apr 2003 11:49:01 -0800 (PST) (envelope-from rfg@monkeys.com) Received: by segfault.monkeys.com (Postfix, from userid 1237) id 7357741F9C; Thu, 3 Apr 2003 11:49:01 -0800 (PST) Message-Id: <20030403194901.7357741F9C@segfault.monkeys.com> Date: Thu, 3 Apr 2003 11:49:01 -0800 (PST) From: "Ronald F.Guilmette" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: "Greg A. Woods" cc: rfg@monkeys.com Subject: docs/50573: return values for res_query/res_search/res_mkquery undocumented X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 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: Thu, 03 Apr 2003 19:50:08 -0000 >Number: 50573 >Category: docs >Synopsis: return values for res_query/res_search/res_mkquery undocumented >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Apr 03 11:50:06 PST 2003 >Closed-Date: >Last-Modified: >Originator: Ronald F. Guilmette >Release: FreeBSD 4.7-RELEASE i386 >Organization: Infinite Monkeys & Co. >Environment: System: FreeBSD segfault.monkeys.com 4.7-RELEASE FreeBSD 4.7-RELEASE #0: Sun Dec 22 23:04:36 PST 2002 rfg@segfault.monkeys.com:/usr/src/sys/compile/rfg20021222 i386 >Description: The man page for res_query and res_search and res_mkquery fails to document the meaning and/or proper interpretation of the (int) values returned from these functions. >How-To-Repeat: man 3 res_query >Fix: The O'Reilly DNS and BIND book, Third Edition, documents the return values for rese_search and res_query on page 348, first paragraph. These two functions are documented (in that book) as returning -1 in case of errors or else the size of the (successful) response packet. This information should be included also on the FreeBSD man page. I have no idea what a proper fix would be in the case of res_mkquery. i have no idea what this function is supposed to return. >Release-Note: >Audit-Trail: >Unformatted: