LinNeighborhood Configuration ============================= Quick Start ----------- In most cases it isn't necessary to configure every detail in the preferences to start browsing. In fact, there's only one 'must' in the preferences dialog: - workgroup It's very important to insert your machine's workgroup in this field. After doing you likely can start browsing. Sometimes you must do more ( -> master browsers ), take a look at the README for further details. Here are some global hints to configure LinNeighborhood: ------------------------------------------------------- In fact, you have two possibilities to configure LinNeighborhood: *) local configuration (done by the users) *) global configuration (done by sysadmin) Local (user's) configuration files ================================== Normally LinNeighborhood does store the user's configuration in a subdirectory ".linneighborhood" in the user's home directory. For example if user schmidj's home is "/home/schmidj", the configuration parameters will be stored in the directory "/home/schmidj/.linneighborhood/" in several files. These files are: - 'hosts' - storage place for the user's preferred hosts - 'masterbrowsers' - list of the user's additional master browsers - 'mountpoints' - list of memorized mounts - 'preferences' - parameters edited in the preferences dialog - 'size' - GUI parameters like window size + height ... Please don't edit this files, that's the job of LinNeighborhood. Global (sysadmin's) configuration file ====================================== To make it more easy for SysAdmins to preconfigure something there's a global system configuration file. The path is "DATADIR/LinNeighborhood/preferences" with DATADIR = "/usr/local/share" as default. You can change it by defining the --datadir=... parameter while configuring of the source package. A user can change the pre definition to his own one, user's definitions have higher priority as global definitions. Example: If you want as SysAdmin to add a special preferred host to every user's GUI, just type the following line to the configuration file: pref_host = mozart After that the host 'mozart' will be inserted to every user's GUI. For more configuration parameters take a look to the local config files. Environment Variables in configuration ====================================== In configuration parameters containing strings, like 'root mount directory', it's possible to use system environment variables. Syntax: "$ENV(variable_name)" It can be useful for global configurations, for example if you want to preset the user's default root mount directories in a special way: The SysAdmin has created a directory "/smbmount/" where the users should mount their directories in a manner like "/smbmount/user1/...." and so on. To do this just type the following into the global prefs file: root_mnt_directory = /smbmount/$ENV(USER)/ The statement $ENV(USER) will be replaced by the value of the environment variable USER. If user schmidj mounts a share "mail" of the host "beethoven", it will be mounted by default to "/smbmount/schmidj/beethoven/mail/". For more aspects of configuration see the README file.