nash - script interpretor to interpret linuxrc images


SYNOPSIS

       nash [--quiet] [--force] script


DESCRIPTION

       nash is a very simple script interpretor designed to be as
       small as possible. It is primarily designed to run  simple
       linuxrc  scripts on an initrd image. Arguments to commands
       may be enclosed in either single or double quotes to allow
       spaces  to be included in the arguments. Spaces outside of
       quotations always delineate arguments,  and  so  backslash
       escaping is supported.

       Additionally,  if  nash  is  invoked  as modprobe, it will
       immediately exit with a return code of zero.  This  is  to
       allow  initrd's  to  prevent  some extraneous kernel error
       messages during startup.

       There are two types of commands, built  in  and  external.
       External   commands   are  run  from  the  filesystem  via
       execve(). If commands names are given without a path, nash
       will  search  it's  builtin PATH, which is /usr/bin, /bin,
       /sbin, /usr/sbin.

       Currently, nash supports the following built in  commands.

       access -[r][w][x][f] path
              Tells  whether the current user has sufficient per­
              missions to read, write, or execture  path,  or  if
              the  file  exists  (see access(2) for more informa­
              tion).

       echo [item]* [> filename]
              Echos the text strings given  to  a  file,  with  a
              space  in  between  each  item.  The  output may be
              optionally redirected to a file.

              exec <command> The command given is  execed,  over­
              laying the nash process.

       find dir -name name
              Display  the  path  to files named name in or below
              directory dirFR.  This is a very limited  implemen­
              tation of find(1).

       losetup /dev/loopdev file
              Binds file to the loopback device /dev/loopdev. See


              mkdir [-p] path Creates the directory path.  If  -p
              is specified, this command will not complain if the
              directory exists. Note this  is  a  subset  of  the
              standard mkdir -p behavior.

       mkrootdev path
              Makes  path  a  block  inode  for  the device whose
              device number is /proc/sys/kernel/real-root-dev.

       mount [--ro] -t type device mntpoint
              Mounts a filesystem. It does not support  NFS,  and
              it must be used in exactly the form given above. If
              --ro is given, the filesystem is mounted read only.
              If  device  is  of  the  form LABEL=foo the devices
              listed in /fB/proc/partitions will be searched, and
              the first device with a volume label of foo will be
              mounted.

       pivot_root newrootpath oldrootpath
              Makes the filesystem mounted at newrootpath the new
              root   filesystem,  and  mounts  the  current  root
              filesystem as oldrootpath.

       raidautorun mddevice
              Runs raid autodetection on  all  raid-typed  parti­
              tions.  mddevice  must  be  a raid device (any will
              do).

       umount path
              Unmounts the filesystem mounted at path.


RETURN VALUE

       Returns 0 is the last command succeeded or 1 if it failed.


OPTIONS

       --force
              Allows force really execute the script, even though
              nash doesn't appear to be running  from  an  initrd
              image.


BUGS

       Probably  many.  nash  is not a shell, and it shouldn't be
       thought of as one. It  isn't  entirely  different  from  a
       shell, but that's mostly by accident.

       Erik Troan <ewt@redhat.com>


Man(1) output converted with man2html