newboot(1M)                                                     newboot(1M)


   NAME
         newboot - install a bootstrap on a boot device

   SYNOPSIS
         newboot -i inputfile -o outputfile [-m message]

   DESCRIPTION
         newboot has two mandatory arguments. The first argument is the name
         of the ELF binary which constitutes the developed version of the
         bootstrap.  The second argument is the name of the output device to
         which the bootstrap will be transferred.

         The -m flag allows the user to specify the message on the command
         line.  Note that the message must be a single token, so if there is
         more than one word the message must be quoted correctly.  If the -m
         flag is not specified, a default value of the current date string is
         provided.

         newboot validates the arguments provided. If the arguments are
         correctly specified, newboot uses image to copy the loadable segments
         from the executable ELF bootstrap to an output file in /tmp as a
         simple binary image.

         A bootstrap header of 512 bytes, including the specified message, is
         then prepended to this simple file using bootaddhdr.

         newboot then uses dd to transfer this simple file to the specified
         device. On completion or error, the working file in /tmp is removed.

   SEE ALSO
         bootaddhdr(1M), image(1M).






















   9/91                                                                 Page 1