home *** CD-ROM | disk | FTP | other *** search
iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) NNNNAAAAMMMMEEEE _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff - add a file to the software installation database SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff [_----_cccc _c_l_a_s_s] _p_k_g_i_n_s_t _p_a_t_h_n_a_m_e [_f_t_y_p_e [[_m_a_j_o_r _m_i_n_o_r] [_m_o_d_e _o_w_n_e_r _g_r_o_u_p]]] _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff [_----_cccc _c_l_a_s_s] _p_k_g_i_n_s_t _---- _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _----_ffff [_----_cccc _c_l_a_s_s] _p_k_g_i_n_s_t DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff informs the system that a pathname not listed in the _pppp_kkkk_gggg_mmmm_aaaa_pppp file is being created or modified. It should be invoked 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: _p_a_t_h_n_a_m_e [_f_t_y_p_e [[_m_a_j_o_r _m_i_n_o_r] [_m_o_d_e _o_w_n_e_r _g_r_o_u_p]]].) After all files have been appropriately created and/or modified, _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff should be invoked with the _----_ffff synopsis to indicate that installation is final. Links will be created at this time and, if attribute information for a pathname was not specified during the original invocation of _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff or was not already stored on the system, the current attribute values for the pathname will be stored. Otherwise, _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff verifies that attribute values match those given on the command line, making corrections as necessary. In all cases, the current content information is calculated and stored appropriately. _----_cccc _c_l_a_s_s Class to which installed objects should be associated. Default class is _nnnn_oooo_nnnn_eeee. _p_k_g_i_n_s_t Name of package instance with which the pathname should be associated. _p_a_t_h_n_a_m_e Pathname that is being created or modified. Special characters, such as an equal sign (_====), are included in pathnames by surrounding the entire pathname in single quotes (as in, for example, _''''_////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_~~~~_====_''''). When a pathname is specified on a shell command line, the single quotes must be preceded by backslashes so they're not interpreted by the shell. _f_t_y_p_e A one-character field that indicates the file type. Possible file types include: PPPPaaaaggggeeee 1111 iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) _ffff a standard executable or data file _eeee a file to be edited upon installation or removal _vvvv volatile file (one whose contents are expected to change) _dddd directory _xxxx an exclusive directory _llll linked file _pppp named pipe _cccc character special device _bbbb block special device _ssss symbolic link _m_a_j_o_r The major device number. The field is only specified for block or character special devices. _m_i_n_o_r The minor device number. The field is only specified for block or character special devices. _m_o_d_e 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 machine. This field is not used for linked or symbolically linked files. _o_w_n_e_r The owner of the file (for example, _bbbb_iiii_nnnn or _rrrr_oooo_oooo_tttt). 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. _g_r_o_u_p The group to which the file belongs (for example, _bbbb_iiii_nnnn or _ssss_yyyy_ssss). The field is limited to 14 characters in length. A question mark (?) indicates that the group 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. PPPPaaaaggggeeee 2222 iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) _----_ffff Indicates that installation is complete. This option is used with the final invocation of _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff (for all files of a given class). NNNNOOOOTTTTEEEESSSS When _f_t_y_p_e is specified, all applicable fields, as shown below, must be defined: cf2 cf2 lf4 lf4. ftype Required Fields p x d f v or _eeee _mmmm_oooo_dddd_eeee _oooo_wwww_nnnn_eeee_rrrr _gggg_rrrr_oooo_uuuu_pppp _cccc or _bbbb _mmmm_aaaa_jjjj_oooo_rrrr _mmmm_iiii_nnnn_oooo_rrrr _mmmm_oooo_dddd_eeee _oooo_wwww_nnnn_eeee_rrrr _gggg_rrrr_oooo_uuuu_pppp The _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff command will create directories, named pipes and special devices on the original invocation. Links are created when _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff is invoked with the _----_ffff option to indicate installation is complete. Links should be specified as _p_a_t_h_1_====_p_a_t_h_2. _p_a_t_h_1 indicates the destination and _p_a_t_h_2 indicates the source file. For symbolically linked files, _p_a_t_h_2 can be a relative pathname, such as _...._//// or _...._...._////. For example, if you enter a line such as _ssss _////_ffff_oooo_oooo_////_bbbb_aaaa_rrrr_////_eeee_tttt_cccc_////_mmmm_oooo_uuuu_nnnn_tttt_====_...._...._////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_mmmm_oooo_uuuu_nnnn_tttt _p_a_t_h_2 (_////_ffff_oooo_oooo_////_bbbb_aaaa_rrrr_////_eeee_tttt_cccc_////_mmmm_oooo_uuuu_nnnn_tttt) will be a symbolic link to _...._...._////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_mmmm_oooo_uuuu_nnnn_tttt. Files installed with _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff will be placed in the class _n_o_n_e, 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, _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff must be used as follows: _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _----_cccc _cccc_llll_aaaa_ssss_ssss_1111 _.... _.... _.... _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _----_ffff _----_cccc _cccc_llll_aaaa_ssss_ssss_1111 _.... _.... _.... _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _----_cccc _cccc_llll_aaaa_ssss_ssss_2222 _.... _.... _.... _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _----_ffff _----_cccc _cccc_llll_aaaa_ssss_ssss_2222 _.... _.... _.... PPPPaaaaggggeeee 3333 iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) iiiinnnnssssttttaaaallllllllffff((((1111MMMM)))) EEEEXXXXAAAAMMMMPPPPLLLLEEEE The following example shows the use of _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff invoked from an optional preinstall or postinstall script: _####_cccc_rrrr_eeee_aaaa_tttt_eeee _////_dddd_eeee_vvvv_////_xxxx_tttt _dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_yyyy _####_((((_nnnn_eeee_eeee_dddd_ssss _tttt_oooo _bbbb_eeee _dddd_oooo_nnnn_eeee _bbbb_eeee_ffff_oooo_rrrr_eeee _dddd_rrrr_vvvv_iiii_nnnn_ssss_tttt_aaaa_llll_llll_)))) _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _$$$$_PPPP_KKKK_GGGG_IIII_NNNN_SSSS_TTTT _////_dddd_eeee_vvvv_////_xxxx_tttt _dddd _7777_5555_5555 _rrrr_oooo_oooo_tttt _ssss_yyyy_ssss _||||_|||| _eeee_xxxx_iiii_tttt _2222 _mmmm_aaaa_jjjj_nnnn_oooo_====_````_////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_dddd_rrrr_vvvv_iiii_nnnn_ssss_tttt_aaaa_llll_llll _----_mmmm _////_eeee_tttt_cccc_////_mmmm_aaaa_ssss_tttt_eeee_rrrr_...._dddd_////_xxxx_tttt _----_dddd _$$$$_BBBB_AAAA_SSSS_EEEE_DDDD_IIII_RRRR_////_dddd_aaaa_tttt_aaaa_////_xxxx_tttt_...._oooo _----_vvvv_1111_...._0000_```` _||||_|||| _eeee_xxxx_iiii_tttt _2222 _iiii_====_0000_0000 _wwww_hhhh_iiii_llll_eeee _[[[[ _$$$$_iiii _----_llll_tttt _$$$$_llll_iiii_mmmm_iiii_tttt _]]]] _dddd_oooo _ffff_oooo_rrrr _jjjj _iiii_nnnn _0000 _1111 _2222 _3333 _4444 _5555 _6666 _7777 _dddd_oooo _eeee_cccc_hhhh_oooo _////_dddd_eeee_vvvv_////_xxxx_tttt_$$$$_iiii_$$$$_jjjj _cccc _$$$$_mmmm_aaaa_jjjj_nnnn_oooo _````_eeee_xxxx_pppp_rrrr _$$$$_iiii _**** _8888 _++++ _$$$$_jjjj_```` _6666_4444_4444 _rrrr_oooo_oooo_tttt _ssss_yyyy_ssss _eeee_cccc_hhhh_oooo _////_dddd_eeee_vvvv_////_xxxx_tttt_$$$$_iiii_$$$$_jjjj_====_////_dddd_eeee_vvvv_////_xxxx_tttt_////_$$$$_iiii_$$$$_jjjj _dddd_oooo_nnnn_eeee _iiii_====_````_eeee_xxxx_pppp_rrrr _$$$$_iiii _++++ _1111_```` _[[[[ _$$$$_iiii _----_llll_eeee _9999 _]]]] _&&&&_&&&& _iiii_====_""""_0000_$$$$_iiii_"""" _####_aaaa_dddd_dddd _llll_eeee_aaaa_dddd_iiii_nnnn_gggg _zzzz_eeee_rrrr_oooo _dddd_oooo_nnnn_eeee _|||| _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _$$$$_PPPP_KKKK_GGGG_IIII_NNNN_SSSS_TTTT _---- _||||_|||| _eeee_xxxx_iiii_tttt _2222 _#### _ffff_iiii_nnnn_aaaa_llll_iiii_zzzz_eeee_dddd _iiii_nnnn_ssss_tttt_aaaa_llll_llll_aaaa_tttt_iiii_oooo_nnnn_,,,, _cccc_rrrr_eeee_aaaa_tttt_eeee _llll_iiii_nnnn_kkkk_ssss _iiii_nnnn_ssss_tttt_aaaa_llll_llll_ffff _----_ffff _$$$$_PPPP_KKKK_GGGG_IIII_NNNN_SSSS_TTTT _||||_|||| _eeee_xxxx_iiii_tttt _2222 SSSSEEEEEEEE AAAALLLLSSSSOOOO _pppp_kkkk_gggg_aaaa_dddd_dddd(1M), _pppp_kkkk_gggg_aaaa_ssss_kkkk(1M), _pppp_kkkk_gggg_cccc_hhhh_kkkk(1), _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo(1), _pppp_kkkk_gggg_mmmm_kkkk(1), _pppp_kkkk_gggg_pppp_aaaa_rrrr_aaaa_mmmm(1), _pppp_kkkk_gggg_pppp_rrrr_oooo_tttt_oooo(1), _pppp_kkkk_gggg_tttt_rrrr_aaaa_nnnn_ssss(1), _pppp_kkkk_gggg_rrrr_mmmm(1M), _rrrr_eeee_mmmm_oooo_vvvv_eeee_ffff(1M) PPPPaaaaggggeeee 4444 
