removef(1M)




NAME

     removef - remove a file from software database


SYNOPSIS

     removef [ [-M] -R root_path] [-V fs_file] pkginst path...

     removef [ [-M] -R root_path] [-V fs_file] -f pkginst


DESCRIPTION

     removef informs the  system  that  the  user,  or  software,
     intends  to  remove  a  pathname. Output from removef is the
     list of input pathnames that may be safely removed (no other
     packages have a dependency on them).


OPTIONS

     The following options are supported:

     -f    After all files have been processed, removef should be
           invoked  with the -f option to indicate that the remo-
           val phase is complete.

     -M    Instruct removef not to use the  $root_path/etc/vfstab
           file  for  determining the client's mount points. This
           option assumes the mount points  are  correct  on  the
           server  and  it  behaves consistently with Solaris 2.5
           and earlier releases.

     -R root_path
           Define the full path name of a directory to use as the
           root_path.  All files, including package system infor-
           mation files, are relocated to a directory tree start-
           ing  in  the specified root_path. The root_path may be
           specified when installing to a client  from  a  server
           (for example, /export/root/client1).

     -V fs_file
           Specify an alternative fs_file  to  map  the  client's
           file  systems.  For  example, used in situations where
           the  $root_path/etc/vfstab  file  is  non-existent  or
           unreliable.


OPERANDS

     The following operands are supported:

     path  The pathname to be removed.

     pkginst
           The package instance from which the pathname is  being
           removed.


EXAMPLES


     Example 1: Using removef

     The  following  example  uses  the  removef  command  in  an
     optional  pre-install script:

     echo "The following files are no longer part of this package
           and are being removed."
     removef $PKGINST /dev/xt[0-9][0-9][0-9] |
     while read pathname
     do
          echo "$pathname"
          rm -f $pathname
     done
     removef -f $PKGINST || exit 2


EXIT STATUS

     0     Successful completion.

     >0    An error occurred.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|


SEE ALSO

     pkginfo(1), pkgmk(1), pkgparam(1), pkgproto(1), pkgtrans(1),
     installf(1M),  pkgadd(1M),  pkgask(1M),  pkgchk(1M),  attri-
     butes(5)

     Application Packaging Developer's Guide


Man(1) output converted with man2html