mk_kernel(1M)                                                 mk_kernel(1M)




 NAME    [Toc]    [Back]
      mk_kernel - load a kernel configuration from a system file

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/mk_kernel [-o path_name] [-s system_file] [-v]

 DESCRIPTION    [Toc]    [Back]
      mk_kernel reads configuration information from the system file (see
      system(4)) and applies those changes to a kernel configuration (see
      kconfig(5)).  mk_kernel performs a function similar to that of
      kconfig -i, but has some semantic differences in order to preserve
      compatibility with previous releases.  mk_kernel will build a new
      kernel executable only if needed to effect the requested changes.
      mk_kernel may reuse existing kernel executables when possible.

    Options    [Toc]    [Back]
      mk_kernel recognizes the following options.

      -o path_name
                Specify the target kernel path.

                If the target kernel path specified is /stand/vmunix,
                changes are applied to the currently running kernel
                configuration.  They will take effect immediately if
                possible; otherwise, they will take effect at next boot.

                If the target kernel path specified is of the form
                /stand/config/vmunix, changes are applied to the saved
                kernel configuration named config.  The changes will not
                take effect at next boot unless that saved kernel
                configuration was already marked for use at next boot.

                If the target kernel name is a single word containing no
                slashes, that name is used as the name of a saved kernel
                configuration.  The changes are applied to that saved kernel
                configuration.  The changes will not take effect at next
                boot unless that saved kernel configuration was already
                marked for use at next boot.

                If the target kernel path is not one of the forms specified
                above, then mk_kernel exits with an error.  Other locations
                for kernel executable files are no longer supported.

                If the -o option is not specified, the changes are applied
                to the kernel configuration called hpux_test.  The changes
                will not take effect at next boot unless that kernel
                configuration was already marked for use at next boot.

      -s system_file
                Specify the HP-UX system description file.  If this option
                is not specified, the system file /stand/system is used.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 mk_kernel(1M)                                                 mk_kernel(1M)




                For details see system(4).

      -v        Verbose mode.  (Has no effect; retained for backward
                compatibility.)

 RETURN VALUE    [Toc]    [Back]
      mk_kernel returns 0 upon normal completion, and 1 if an error
      occurred.

 DIAGNOSTICS    [Toc]    [Back]
      Messages and warnings are sent to stdout.  Messages from kconfig(1M)
      and other commands are displayed when invoked from mk_kernel.  Errors
      cause mk_kernel to halt immediately; warnings allow the program to
      continue.

 EXAMPLES    [Toc]    [Back]
      mk_kernel -o /stand/vmunix

           Uses the default HP-UX system description file /stand/system.
           The changes are applied to the currently running kernel
           configuration, marked to take effect at next boot.

      mk_kernel -s /mnt/altsys/stand/system.new

           Uses the system description file /mnt/altsys/stand/system.new.

      mk_kernel -s /stand/system -o fred

           Uses the system description file /stand/system The changes are
           applied to the saved kernel configuration called fred.

 WARNINGS    [Toc]    [Back]
      Do not manually modify the contents of the kernel configuration
      directories.

 FILES    [Toc]    [Back]
      /stand/system       Default HP-UX system description file

 SEE ALSO    [Toc]    [Back]
      system(4), kconfig(5), kconfig(1M).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003