NAME

tlinstall - create HP-UX 9.x to 10.0 transition links

tlremove - remove HP-UX 9.x to 10.0 transition links

SYNOPSIS

tlinstall [-v] [filesets]

tlremove [-v] [-f] [-d] [filesets]

DESCRIPTION

To provide 9.x/10.x interoperability, tlinstall generates mappings of 10.x HP-UX file and directory names to corresponding 9.x HP-UX file and directory names by creating transition links from the 9.x names to the new 10.0 names.  These transition links are specified by entries defined in the 9.x to 10.0 Transition Tools Data Base, the TTDB.  (NOTE: not all 9.x files and directories are mapped to corresponding 10.0 files and directories). 

tlremove is the inverse of tlinstall and removes transition links that have been installed on the system by tlinstall.  tlremove is also used to remove dangling transition and/or symbolic links. 

Transition Links can only be installed or removed on a per fileset or group of filesets basis.  The specified filesets have to be 9.x filesets which are already installed on the target system.  All messages generated by tlinstall or tlremove are written to stdout. 

To differentiate these special-purpose transition links from other symbolic links on the system, tlinstall sets the sticky bit in the inode of the 10.x named link of each mapping.  In addition, the file access mode for the newly created transition link will be set to match the 9.0 target file’s access mode. 

Only the super-user may run tlinstall and tlremove. 

Options

tlinstall recognizes the following options:

-v Normally, tlinstall does its work silently.  The -v (verbose) option causes tlinstall to display warning messages for transition links which tlinstall fails to create. 

tlremove recognizes the following options:

-v Normally, tlremove does its work silently.  The -v (verbose) option causes tlremove to display warning messages for transition links which tlremove fails to remove. 

-f Normally, tlremove does not remove any existing symbolic link which uses a 10.x file or directory name specified in the TTDB.  The -f (force) option causes tlremove to remove these symbolic links. 

-d This option restricts tlremove to remove dangling transition links only.  If -f option is specified, dangling symbolic links will be also removed.  Dangling transition/symbolic links are 10.x named links (specified in TTDB ) that point to non-existent files or directories.  Note that if the -d option is used, optional filesets can not be specified. 

EXAMPLES

The following command will result in transition links being created for all the 9.x filesets which are already installed on the system. Also, warning messages will be displayed. 

tlinstall -v

The next useage will result in transition links being created for the MAILERS fileset without displaying warning messages. 

tlinstall MAILERS

This next useage will result in all transition links being removed from the system and warning messages are displayed. 

tlremove -v

This next useage will result in all dangling transition links being removed from the system. 

tlremove -d

This next useage will result in all dangling transition links and dangling symbolic links being removed from the system. 

tlremove -f -d

WARNINGS

If tlinstall encounters an existing link from a 10.x file or directory name to a non-existent file, it will remove the link and create the correct transition link to the corresponding 9.x file. 

If tlinstall encounters an existing symbolic link from a 10.x file or directory name to the correct 9.x file or directory name, it will leave it as a symbolic link without setting the sticky bit. 

If tlinstall encounters an existing transition link from a 10.x file or directory name to a file or directory other than the 9.x file or directory name specified in the TTDB, it will clear the sticky bit to convert that transition link.  into a symbolic link. 

If tlinstall fails to find the 9.x file or directory for a transition link, tlinstall will not set up the transition link.  In addition, no warning messages are displayed. 

If tlremove encounters a transition link mapping to the wrong file it will unset the sticky bit (if set) to convert that transition link into a symbolic link.  If the -f option is specified, this symbolic link will be removed. 

DIAGNOSTICS

tlinstall and tlremove will complain and print a warning message on stdout when the following conditions are encountered:

10.x file already exists and is not a link. 

10.x link already exists and is linked to the wrong file. 

bad 10.x link found. 

bad 9.x file found. 

tlinstall and tlremove return 0 if links were successfully installed or removed and 1 if not. 

DEPENDENCIES

tlinstall and tlremove will create and remove transition links as they are defined in the TTDB. 

AUTHOR

tlinstall and tlremove were developed by HP. 

SEE ALSO

ln(1),

Hewlett-Packard Company  —  HP-UX Release 9.1: January 1994