From owner-svn-src-stable-7@FreeBSD.ORG Tue Jun 16 13:39:09 2009 Return-Path: Delivered-To: svn-src-stable-7@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EDF51106566B; Tue, 16 Jun 2009 13:39:09 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id C15518FC17; Tue, 16 Jun 2009 13:39:09 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id n5GDd9UO029234; Tue, 16 Jun 2009 13:39:09 GMT (envelope-from jhb@svn.freebsd.org) Received: (from jhb@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id n5GDd9gO029232; Tue, 16 Jun 2009 13:39:09 GMT (envelope-from jhb@svn.freebsd.org) Message-Id: <200906161339.n5GDd9gO029232@svn.freebsd.org> From: John Baldwin Date: Tue, 16 Jun 2009 13:39:09 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-7@freebsd.org X-SVN-Group: stable-7 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r194291 - stable/7/lib/libutil X-BeenThere: svn-src-stable-7@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for only the 7-stable src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 16 Jun 2009 13:39:10 -0000 Author: jhb Date: Tue Jun 16 13:39:09 2009 New Revision: 194291 URL: http://svn.freebsd.org/changeset/base/194291 Log: MFC: Note that these routines return NULL on failure and that the structures they return arrays of are defined in . Modified: stable/7/lib/libutil/ (props changed) stable/7/lib/libutil/kinfo_getfile.3 stable/7/lib/libutil/kinfo_getvmmap.3 Modified: stable/7/lib/libutil/kinfo_getfile.3 ============================================================================== --- stable/7/lib/libutil/kinfo_getfile.3 Tue Jun 16 13:31:01 2009 (r194290) +++ stable/7/lib/libutil/kinfo_getfile.3 Tue Jun 16 13:39:09 2009 (r194291) @@ -58,15 +58,20 @@ mib. While the kernel returns a packed structure, this function expands the data into a fixed record format. .Sh RETURN VALUES -The +On success the .Fn kinfo_getfile function returns a pointer to an array of .Vt struct kinfo_file -structures. +structures as defined by +.In sys/user.h . The array was obtained by an internal call to .Xr malloc 3 and must be freed by the caller with a call to .Xr free 3 . +On failure the +.Fn kinfo_getfile +function returns +.Dv NULL . .Sh SEE ALSO .Xr free 3 , .Xr kinfo_getvmmap 3 , Modified: stable/7/lib/libutil/kinfo_getvmmap.3 ============================================================================== --- stable/7/lib/libutil/kinfo_getvmmap.3 Tue Jun 16 13:31:01 2009 (r194290) +++ stable/7/lib/libutil/kinfo_getvmmap.3 Tue Jun 16 13:39:09 2009 (r194291) @@ -58,15 +58,20 @@ mib. While the kernel returns a packed structure, this function expands the data into a fixed record format. .Sh RETURN VALUES -The +On success the .Fn kinfo_getvmmap function returns a pointer to an array of .Vt struct kinfo_vmentry -structures. +structures as defined by +.In sys/user.h . The array was obtained by an internal call to .Xr malloc 3 and must be freed by the caller with a call to .Xr free 3 . +On failure the +.Fn kinfo_getvmmap +function returns +.Dv NULL . .Sh SEE ALSO .Xr free 3 , .Xr kinfo_getfile 3 ,