NAME    [Toc]    [Back]

     getbootfile -- get kernel boot file name

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <paths.h>

     const char *
     getbootfile(void);

DESCRIPTION    [Toc]    [Back]

     The getbootfile() function retrieves the full pathname of the file from
     which the current kernel was loaded, and returns a static pointer to the
     name.  A read/write interface to this information is available via the
     sysctl(3) MIB variable ``kern.bootfile''.

RETURN VALUES    [Toc]    [Back]

     If the call succeeds a string giving the pathname is returned.  If it
     fails, a null pointer is returned and an error code is placed in the
     global location errno.

SEE ALSO    [Toc]    [Back]

     sysctl(3)

BUGS    [Toc]    [Back]

     If the boot blocks have not been modified to pass this information into
     the kernel at boot time, the static string ``/boot/kernel/kernel'' is
     returned instead of the real boot file.

HISTORY    [Toc]    [Back]

     The getbootfile() function appeared in FreeBSD 2.0.


FreeBSD 5.2.1		      September 23, 1994		 FreeBSD 5.2.1