System Administration Commands                     updatehome(1M)



NAME
     updatehome - update the home directory copy and  link  files
     for the current label

SYNOPSIS
     /usr/bin/updatehome  [-cirs]


DESCRIPTION
     updatehome reads the user's  minimum-label  copy  and  link-
     control  files  (.copyfiles  and  .linkfiles). These files
     contain a list of files to be copied and symbolically linked
     from  the  user's minimum-label home directory to the user's
     home directory at the current label.


     The Solaris Trusted Extensions dtsession program performs an
     updatehome  whenever a newly labeled workspace is created so
     that the user's favorite files are available  for  use.  For
     example,  the  user  probably  wants a symbolic link to such
     files as  .profile,  .login,  .cshrc,  .exrc,  .mailrc,  and
     ~/bin.  The updatehome command provides a convenient mechan-
     ism for accomplishing this symlink. The user can  add  files
     to  those to be copied (.copyfiles) and to those to be sym-
     bolically linked (.linkfiles).

OPTIONS
     -c    Replace existing home-directory copies at the  current
           label. The default is to skip over existing copies.


     -i    Ignore  errors  encountered.  The  default  aborts  on
           error.


     -r    Replace existing  home-directory  copies  or  symbolic
           links  at  the  current  label.  This  option  implies
           options -c and -s. The default is to skip over  exist-
           ing copies or symbolic links.


     -s    Replace existing home-directory symbolic links at  the
           current  label.  The  default is to skip over existing
           symbolic links.


EXIT STATUS
     Upon success, updatehome returns 0. Upon failure, updatehome
     returns 1 and writes diagnostic messages to standard error.

EXAMPLES




SunOS 5.11          Last change: 20 Jul 2007                    1






System Administration Commands                     updatehome(1M)



     Example 1 A Sample .copyfiles File


     The files that are listed in .copyfiles can be modified  at
     every user's label.


       .cshrc
       .mailrc
       .mozilla/bookmarks.html



     Example 2 A Sample .linkfiles File


     The files that are listed in .linkfiles can be modified  at
     the  lowest label. The changes propagate to the other labels
     that are available to the user.


       ~/bin
       .mozilla/preferences
       .xrc
       .rhosts



     Example 3 Updating the Linked and Copied Files


     The .copyfiles and .linkfiles were updated by the user  at
     the minimum label. At a higher label, the user refreshes the
     copies and the links. No privileges are required to run  the
     command.


       % updatehome -r



FILES
     $HOME/.copyfiles    List of files to be copied


     $HOME/.linkfiles    List of files to be symbolically linked


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




SunOS 5.11          Last change: 20 Jul 2007                    2






System Administration Commands                     updatehome(1M)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWtsu                     
    
     Interface Stability          Committed                   
    


SEE ALSO
     attributes(5)


     .copyfiles and .linkfiles Files in Solaris Trusted  Exten-
     sions Administrator's Procedures

NOTES
     The functionality described on this manual page is available
     only if the system is configured with Trusted Extensions.




































SunOS 5.11          Last change: 20 Jul 2007                    3