xref: /netbsd-src/lib/libkvm/kvm_getkernelname.3 (revision 267db0c5468107a000da016f7b6bad92350b351c)
1*267db0c5Swiz.\"	$NetBSD: kvm_getkernelname.3,v 1.2 2011/09/13 08:53:10 wiz Exp $
28171e48bSchristos.\"
38171e48bSchristos.\"
48171e48bSchristos.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
58171e48bSchristos.\" All rights reserved.
68171e48bSchristos.\"
78171e48bSchristos.\" This code is derived from software contributed to The NetBSD Foundation
88171e48bSchristos.\" by Christos Zoulas.
98171e48bSchristos.\"
108171e48bSchristos.\" Redistribution and use in source and binary forms, with or without
118171e48bSchristos.\" modification, are permitted provided that the following conditions
128171e48bSchristos.\" are met:
138171e48bSchristos.\" 1. Redistributions of source code must retain the above copyright
148171e48bSchristos.\"    notice, this list of conditions and the following disclaimer.
158171e48bSchristos.\" 2. Redistributions in binary form must reproduce the above copyright
168171e48bSchristos.\"    notice, this list of conditions and the following disclaimer in the
178171e48bSchristos.\"    documentation and/or other materials provided with the distribution.
188171e48bSchristos.\" 3. All advertising materials mentioning features or use of this software
198171e48bSchristos.\"    must display the following acknowledgement:
208171e48bSchristos.\"        This product includes software developed by the NetBSD
218171e48bSchristos.\"        Foundation, Inc. and its contributors.
228171e48bSchristos.\" 4. Neither the name of The NetBSD Foundation nor the names of its
238171e48bSchristos.\"    contributors may be used to endorse or promote products derived
248171e48bSchristos.\"    from this software without specific prior written permission.
258171e48bSchristos.\"
268171e48bSchristos.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
278171e48bSchristos.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
288171e48bSchristos.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
298171e48bSchristos.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
308171e48bSchristos.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
318171e48bSchristos.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
328171e48bSchristos.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
338171e48bSchristos.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
348171e48bSchristos.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
358171e48bSchristos.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
368171e48bSchristos.\" POSSIBILITY OF SUCH DAMAGE.
378171e48bSchristos.\"
388171e48bSchristos.Dd September 14, 2011
398171e48bSchristos.Dt KVM_GETKERNELNAME 3
408171e48bSchristos.Os
418171e48bSchristos.Sh NAME
428171e48bSchristos.Nm kvm_getkernelname
438171e48bSchristos.Nd get kernel name of opened kvm descriptor
448171e48bSchristos.Sh LIBRARY
458171e48bSchristos.Lb libkvm
468171e48bSchristos.Sh SYNOPSIS
478171e48bSchristos.In kvm.h
488171e48bSchristos.Ft const char *
498171e48bSchristos.Fn kvm_getkernelname "kvm_t *kd"
508171e48bSchristos.Sh DESCRIPTION
518171e48bSchristosThis function returns a string containing the kernel name used from the kvm
528171e48bSchristosdescriptor obtained by a previous
53*267db0c5Swiz.Xr kvm_open 3
548171e48bSchristosor
55*267db0c5Swiz.Xr kvm_openfiles 3
568171e48bSchristoscall.
578171e48bSchristos.Sh SEE ALSO
588171e48bSchristos.Xr kvm 3 ,
598171e48bSchristos.Xr kvm_close 3 ,
608171e48bSchristos.Xr kvm_getargv 3 ,
618171e48bSchristos.Xr kvm_getenvv 3 ,
628171e48bSchristos.Xr kvm_getprocs 3 ,
638171e48bSchristos.Xr kvm_nlist 3 ,
648171e48bSchristos.Xr kvm_open 3 ,
658171e48bSchristos.Xr kvm_openfiles 3 ,
668171e48bSchristos.Xr kvm_read 3 ,
678171e48bSchristos.Xr kvm_write 3
68