updatehome(1m)

1updatehome(1M)          System Administration Commands          updatehome(1M)
2
3
4

NAME

6       updatehome - update the home directory copy and link files for the cur‐
7       rent label
8

SYNOPSIS

10       /usr/bin/updatehome  [-cirs]
11
12

DESCRIPTION

14       updatehome reads the user's minimum-label copy and  link-control  files
15       (.copy_files  and  .link_files). These files contain a list of files to
16       be copied and symbolically linked from the  user's  minimum-label  home
17       directory to the user's home directory at the current label.
18
19
20       The Solaris Trusted Extensions dtsession program performs an updatehome
21       whenever a newly labeled  workspace  is  created  so  that  the  user's
22       favorite  files  are  available for use. For example, the user probably
23       wants a symbolic link to such files as .profile, .login, .cshrc, .exrc,
24       .mailrc, and ~/bin. The updatehome command provides a convenient mecha‐
25       nism for accomplishing this symlink. The user can add files to those to
26       be  copied  (.copy_files)  and  to  those  to  be  symbolically  linked
27       (.link_files).
28

OPTIONS

30       -c    Replace existing home-directory copies at the current label.  The
31             default is to skip over existing copies.
32
33
34       -i    Ignore errors encountered. The default aborts on error.
35
36
37       -r    Replace  existing  home-directory copies or symbolic links at the
38             current label. This option implies options -c and -s. The default
39             is to skip over existing copies or symbolic links.
40
41
42       -s    Replace  existing  home-directory  symbolic  links at the current
43             label. The default is to skip over existing symbolic links.
44
45

EXIT STATUS

47       Upon success, updatehome returns 0. Upon failure, updatehome returns  1
48       and writes diagnostic messages to standard error.
49

EXAMPLES

51       Example 1 A Sample .copy_files File
52
53
54       The  files  that  are  listed  in  .copy_files can be modified at every
55       user's label.
56
57
58         .cshrc
59         .mailrc
60         .mozilla/bookmarks.html
61
62
63
64       Example 2 A Sample .link_files File
65
66
67       The files that are listed in .link_files can be modified at the  lowest
68       label.  The changes propagate to the other labels that are available to
69       the user.
70
71
72         ~/bin
73         .mozilla/preferences
74         .xrc
75         .rhosts
76
77
78
79       Example 3 Updating the Linked and Copied Files
80
81
82       The .copy_files and .link_files were updated by the user at the minimum
83       label.  At a higher label, the user refreshes the copies and the links.
84       No privileges are required to run the command.
85
86
87         % updatehome -r
88
89
90

FILES

92       $HOME/.copy_files    List of files to be copied
93
94
95       $HOME/.link_files    List of files to be symbolically linked
96
97

ATTRIBUTES

99       See attributes(5) for descriptions of the following attributes:
100
101
102
103
104       ┌─────────────────────────────┬─────────────────────────────┐
105       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
106       ├─────────────────────────────┼─────────────────────────────┤
107       │Availability                 │SUNWtsu                      │
108       ├─────────────────────────────┼─────────────────────────────┤
109       │Interface Stability          │Committed                    │
110       └─────────────────────────────┴─────────────────────────────┘
111

NOTES

120       The  functionality  described  on this manual page is available only if
121       the system is configured with Trusted Extensions.
122
123
124
125SunOS 5.11                        20 Jul 2007                   updatehome(1M)