Every home directory are free to use at the user's own personal discretion.
However, there are some standard subdirectories: "HOME:S/", "HOME:EnvArc/",
"HOME:T/", "HOME:Trashcan/" and "HOME:Settings/".
HOME:
+- Settings
| +- Programs/
| | +- SnoopDOS/
| | +- XDME/
| | +- ...
| +- UI/ [reserved]
| +- HDToolBox.prui
| +- Calculator.prui
| +- ...
+- S/
| +- User-Startup
| +- ...
+- EnvArc/
| +- Sys/
| +- User.prefs
+- T/
+- Trashcan/
The subdirectories carry user preferences. The preferences programs and
"IPrefs" will have to know about this, and so will AROS applications, which
will store non-variable data in HOME:Settings/Programs/<ProgramName>.
The "HOME:Settings/UI/" subdirectory is reserved for system use. This
directory stores information about application User Interface ("UI"). We've
defined a new IFF standard for this purpose - "IFF-PRUI" ("Persistant User
Interface"). Read more about this in the IFF-PRUI RFC.
"HOME:EnvArc/Sys/User.prefs" holds information about the user him/herself.
Although this IFF-format is yet to be determined, it will contain data such
as the user's real name and e-mail address.
(Permanent) shell variables will be stored in "HOME:EnvArc/". Every user gets
his or her own personal trashcan ("HOME:Trashcan/"). Also note that all users
have their own "User-Startup" script (stored in HOME:S/) and a directory for
temporary data (HOME:T/).
The "System" home directory (SYS:Home/System/) is used by the AROS system
itself, mainly for system defaults and system "global" settings (such as user
passwords). If an application fails finding some given settings in the HOME:
directory, the System directory should be searched for the system default
settings.
The "HOME:" assign will be given by the AROS Login Manager, once the user
has authorized him/herself. When AROS is being installed on a new system,
the Installer will ask the user whether he'd like AROS Login Manager to show
up or not. Although the Login Manager will launch a GUI by default, this can
be overridden by passing USER and PASSWORD ReadArgs() style arguments. In
this case, the user will have exclusive access to the AROS system.
When the user logs out, the HOME: directory assign will reset to
SYS:Home/System/.
A long term goal should be dos.library support for multiple assign targets in
case AROS will support several users logged on the same system simultanously
(eg. thru ssh/nfs/samba access).