Maintenance Commands                                  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
     -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
     pkginst
           The package instance from which the pathname is  being
           removed.

     path  The pathname to be removed.

EXAMPLES
     Example 1: The removef command.

SunOS 5.8            Last change: 4 Oct 1996                    1

Maintenance Commands                                  removef(1M)

     The following shows the use of removef 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),  attributes(5)
     

     Application Packaging Developer's Guide

SunOS 5.8            Last change: 4 Oct 1996                    2