xref: /minix3/lib/libutil/getbootfile.3 (revision 0c3983b25a88161cf074524e5c94585a2582ae82)
1*0c3983b2SBen Gras.\"	$NetBSD: getbootfile.3,v 1.9 2010/05/04 06:41:27 jruoho Exp $
2*0c3983b2SBen Gras.\"
3*0c3983b2SBen Gras.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
4*0c3983b2SBen Gras.\" All rights reserved.
5*0c3983b2SBen Gras.\"
6*0c3983b2SBen Gras.\" This code is derived from software contributed to The NetBSD Foundation
7*0c3983b2SBen Gras.\" by Thomas Klausner.
8*0c3983b2SBen Gras.\"
9*0c3983b2SBen Gras.\" Redistribution and use in source and binary forms, with or without
10*0c3983b2SBen Gras.\" modification, are permitted provided that the following conditions
11*0c3983b2SBen Gras.\" are met:
12*0c3983b2SBen Gras.\" 1. Redistributions of source code must retain the above copyright
13*0c3983b2SBen Gras.\"    notice, this list of conditions and the following disclaimer.
14*0c3983b2SBen Gras.\" 2. Redistributions in binary form must reproduce the above copyright
15*0c3983b2SBen Gras.\"    notice, this list of conditions and the following disclaimer in the
16*0c3983b2SBen Gras.\"    documentation and/or other materials provided with the distribution.
17*0c3983b2SBen Gras.\"
18*0c3983b2SBen Gras.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19*0c3983b2SBen Gras.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20*0c3983b2SBen Gras.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21*0c3983b2SBen Gras.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22*0c3983b2SBen Gras.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23*0c3983b2SBen Gras.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24*0c3983b2SBen Gras.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25*0c3983b2SBen Gras.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26*0c3983b2SBen Gras.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27*0c3983b2SBen Gras.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28*0c3983b2SBen Gras.\" POSSIBILITY OF SUCH DAMAGE.
29*0c3983b2SBen Gras.\"
30*0c3983b2SBen Gras.Dd May 4, 2010
31*0c3983b2SBen Gras.Dt GETBOOTFILE 3
32*0c3983b2SBen Gras.Os
33*0c3983b2SBen Gras.Sh NAME
34*0c3983b2SBen Gras.Nm getbootfile
35*0c3983b2SBen Gras.Nd get the name of the booted kernel file
36*0c3983b2SBen Gras.Sh LIBRARY
37*0c3983b2SBen Gras.Lb libutil
38*0c3983b2SBen Gras.Sh SYNOPSIS
39*0c3983b2SBen Gras.In util.h
40*0c3983b2SBen Gras.Ft const char *
41*0c3983b2SBen Gras.Fn getbootfile void
42*0c3983b2SBen Gras.Sh DESCRIPTION
43*0c3983b2SBen Gras.Fn getbootfile
44*0c3983b2SBen Grasreturns a static pointer to the full path name of the file from which
45*0c3983b2SBen Grasthe current kernel was loaded.
46*0c3983b2SBen GrasIf it can not be determined, or the file is not ``secure'' (see
47*0c3983b2SBen Gras.Xr secure_path 3 ) ,
48*0c3983b2SBen Gras.Dv _PATH_UNIX
49*0c3983b2SBen Grasfrom
50*0c3983b2SBen Gras.In paths.h
51*0c3983b2SBen Grasis returned instead.
52*0c3983b2SBen Gras.Sh SEE ALSO
53*0c3983b2SBen Gras.Xr secure_path 3 ,
54*0c3983b2SBen Gras.Xr sysctl 3
55*0c3983b2SBen Gras.Sh HISTORY
56*0c3983b2SBen GrasThe
57*0c3983b2SBen Gras.Fn getbootfile
58*0c3983b2SBen Grasfunction call appeared in
59*0c3983b2SBen Gras.Fx 2.0
60*0c3983b2SBen Grasand
61*0c3983b2SBen Gras.Nx 1.6 .
62