installf(8) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

installf(8)

installf(8)             System Administration Commands             installf(8)

NAME
       installf - add a file to the SVR4 package database

SYNOPSIS
       installf [-c class] [ [-M] -R root_path] [-V fs_file] pkginst pathname
            [ftype [major minor] [mode owner group]]


       installf [-c class] [ [-M] -R root_path] [-V fs_file] pkginst -


       installf -f [-c class] [ [-M] -R root_path] [-V fs_file] pkginst

DESCRIPTION
       installf  informs  the SVR4 packaging system that a pathname not listed
       in the pkgmap(5) file is being created or modified. It  should  be  in‐
       voked before any file modifications have occurred.


       When  the  second  synopsis  is used, the pathname descriptions will be
       read from standard input. These descriptions are the same as  would  be
       given in the first synopsis but the information is given in the form of
       a list. The descriptions should be in the form:


       pathname [ ftype [ major  minor ] [ mode  owner  group ]]


       After  all  files  have been appropriately created and/or modified, in‐
       stallf should be invoked with the -f synopsis to indicate that  instal‐
       lation  is  final. Links will be created at this time and, if attribute
       information for a pathname was not specified during the original  invo‐
       cation  of  installf, or was not already stored on the system, the cur‐
       rent attribute values for the pathname will be stored.  Otherwise,  in‐
       stallf  verifies that attribute values match those given on the command
       line, making corrections as necessary. In all cases, the  current  con‐
       tent information is calculated and stored appropriately.

OPTIONS
       -c class        Class  to which installed objects should be associated.
                       Default class is none.


       -f              Indicates that installation is complete. This option is
                       used with the final invocation  of  installf  (for  all
                       files of a given class).


       -M              Instruct  installf 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 informa‐
                       tion  files, are relocated to a directory tree starting
                       in the specified root_path. The root_path can be speci‐
                       fied when installing to a client from a server (for ex‐
                       ample, /export/root/client1).

                       installf inherits the value of the PKG_INSTALL_ROOT en‐
                       vironment variable. (See ENVIRONMENT VARIABLES, below.)
                       If PKG_INSTALL_ROOT is set, such as when the -R  option
                       is used with pkgadd(8) or pkgrm(8)

                       Note -



                         The root file system of any non-global zones must not
                         be referenced with the -R option. Doing so might dam‐
                         age  the  global zone's file system, might compromise
                         the security of the global zone, and might damage the
                         non-global zone's file system. See zones(7).



       -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 unreli‐
                       able.


OPERANDS
       pkginst     Name of package instance with which the pathname should  be
                   associated.


       pathname    Pathname that is being created or modified.


       ftype       A  one-character field that indicates the file type. Possi‐
                   ble file types include:

                   b    block special device


                   c    character special device


                   d    directory


                   e    a file to be edited upon installation or removal


                   f    a standard executable or data file


                   l    linked file


                   p    named pipe


                   s    symbolic link


                   v    volatile file (one  whose  contents  are  expected  to
                        change)


                   x    an exclusive directory



       major       The  major  device  number. The field is only specified for
                   block or character special devices.


       minor       The minor device number. The field is  only  specified  for
                   block or character special devices.


       mode        The  octal mode of the file (for example, 0664). A question
                   mark (?) indicates that the mode will  be  left  unchanged,
                   implying  that  the  file  already exists on the target ma‐
                   chine. This field is not used for  linked  or  symbolically
                   linked files.


       owner       The owner of the file (for example, bin or root). The field
                   is  limited to 14 characters in length. A question mark (?)
                   indicates that the owner will be left  unchanged,  implying
                   that  the  file  already exists on the target machine. This
                   field is not used for linked or symbolically linked files.


       group       The group to which the file belongs (for  example,  bin  or
                   sys).  The  field  is limited to 14 characters in length. A
                   question mark (?) indicates that the group will be left un‐
                   changed, implying that the file already exists on the  tar‐
                   get  machine. This field is not used for linked or symboli‐
                   cally linked files.


EXAMPLES
       Example 1 Basic Usage



       The following example shows the use of installf, invoked  from  an  op‐
       tional pre-install or post-install script:


         # create /dev/xt directory
         # (needs to be done before drvinstall)
         installf $PKGINST /dev/xt d 755 root sys || exit 2
         majno=`/usr/sbin/drvinstall -m /etc/master.d/xt
             -d $BASEDIR/data/xt.o -v1.0` || exit 2
         i=00
         while [ $i −lt $limit ]
         do
             for j in 0 1 2 3 4 5 6 7
             do
                 echo /dev/xt$i$j c $majno `expr $i ? 8 + $j` 644 root sys |
                 echo /dev/xt$i$j=/dev/xt/$i$j
             done
             i=`expr $i + 1`
             [ $i −le 9 ] && i="0$i" # add leading zero
         done | installf $PKGINST − || exit 2
         # finalized installation, create links
         installf -f $PKGINST || exit 2


ENVIRONMENT VARIABLES
       installf inherits the value of the following environment variable. This
       variable  is  set when pkgadd(8) or pkgrm(8) is invoked with the -R op‐
       tion.

       PKG_INSTALL_ROOT    If present, defines the full path name of a  direc‐
                           tory  to use as the system's PKG_INSTALL_ROOT path.
                           All product and package information files are  then
                           looked for in the directory tree, starting with the
                           specified  PKG_INSTALL_ROOT  path.  If not present,
                           the default system path of / is used.


EXIT STATUS
       0     Successful operation.


       >0    An error occurred.


USAGE
       The installf command is used when installing legacy SVR4 packages  cre‐
       ated  for  older Solaris releases. Packages designed for Solaris 11 and
       later releases use the IPS package system instead,  and  are  installed
       and  managed using the pkg(1) command. There is no direct equivalent to
       installf in IPS, as all files to be installed by an IPS package must be
       listed in the package manifest, and installation scripts are  not  sup‐
       ported.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Availabilitypackage/svr4


SEE ALSO
       pkginfo(1), pkgmk(1), pkgparam(1), pkgproto(1), pkgtrans(1), pkgmap(5),
       space(5), attributes(7), pkgadd(8), pkgask(8), pkgchk(8), pkgrm(8), re‐
       movef(8)

NOTES
       When ftype is specified, all applicable fields, as shown below, must be
       defined:

       tab() box; cw(2.75i) cw(2.75i) lw(2.75i) lw(2.75i) ftypeRequired Fields
       p, x, d, f, v, or emode owner group c or bmajor minor mode owner group



       The installf command will create directories, named pipes  and  special
       devices  on the original invocation. Links are created when installf is
       invoked with the -f option to indicate installation is complete.


       Links should be specified as path1=path2. path1 indicates the  destina‐
       tion and path2 indicates the source file.


       Files  installed with installf will be placed in the class none, unless
       a class is defined with the command. Subsequently, they will be removed
       when the associated package is deleted. If  this  file  should  not  be
       deleted  at  the same time as the package, be certain to assign it to a
       class which is ignored at removal time. If special action  is  required
       for  the  file before removal, a class must be defined with the command
       and an appropriate class action script delivered with the package.


       When classes are used, installf must be used in one  of  the  following
       forms:

         installf -c class1 ...
         installf -f -c class1 ...
         installf -c class2 ...
         installf -f -c class2 ...


HISTORY
       Support for the -A, -M, and -V options was added in Solaris 2.6.


       Support for the -R option was added in Solaris 2.1.


       The  installf utility, including support for the -c and -f options, was
       added to Solaris in Solaris 2.0.

Oracle Solaris 11.4               3 Jan 2025                       installf(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3