ws

NAME

SYNOPSIS

DESCRIPTION

ws on - mounts the shares
ws off - unmount the shares

ws on command forces the user to enter the password to authenticate against samba server.
The authentication (username and password) can be automated creating an authentication file ( -a option).
To bypass the auth file use the -u and/or -p options (ws -u name -p pass on)
Several optional authentication files can be created to automate distinct servers with different authentications (ws -a server).
The -U option allows to automate mounting the shares during login and unmounting during logout.
If you are working in a text mode environment, add the command ws -U on to user's file .bashrc, and the command ws -f off to .bash_logout.
Then, the user who wishes to mount automatically, have to change the configuration file option AUTO="yes".
If you are working in a graphical environment with GDM (Gnome Display Manager), you can run the command ws-auto on and change the configuration file option AUTO to "yes", in each user you want to automate mounting.
A new directory named WinShare is created in user's home directory hosting the mounted samba and windows shares. If you are in a graphical environment, a WinShare soft link in Desktop is automatically created.
This name may be changed in the configuration file (see man ws.conf)  

OPTIONS

-f off

= Force unmount. Only valid with "off"

-i

= Interactive. Bypass the authentication file allowing to enter name and password

-a [file]

= Authentication file creation. Optional authfile name

-ax [file]

= Authentication file deletion. Optional authfile name

-al

= Authentication files list

-c

= Configuration file creation or edition

-cx

= Configuration file deletion

-u

= Input username manually without using authentication file

-p

= Input password manually without using authentication file

-U

= Automatic apply of login user in setup scripts.

-s

= Status (default).Output authentication file and mounted shares

-q

= Quiet. Do not write anything to standard output. Only to logfile.

-V | --version

= Version

-h | --help

= Help

--debug

= Debug mode.Verbose messages with line number.

EXAMPLES

ws off - unmount shares and delete directories created for the effect.

ws - is the same as ws -s. It shows if the configuration file is owned by the user or by the system. If a default authfile exists, how many shares are mounted by this user, and the shares list. Shares mounted by other users are not showed.

ws -i on - Bypass authfile, asking for username and password instead of using   authentication file.

ws -a - Creates a new default authentication file. It asks for username and password to be entered.

ws -a name_auth - Creates a new authentication file with any name you wish. This is different from the default one. This authfile can be linked to a server or share in the ws.conf file, if for some reason the username and passwords are different from the default one.

ws -ax - Deletes the default authfile.

ws -al - Lists all user authentication files.

ws -ax name_auth - Deletes the optional authfile.

ws -c - Creates or edit the configuration file for the actual user. This option uses the default editor to open the ws.conf file. If there is a /etc/ws.conf (the winshares system configuration file), the user configuration file is copied from that one. If there is no system configuration file, it creates a hardcoded new file.

ws -cx - Deletes the configuration file.

ws -u name on - Mount the shares using a default username different from the actual user.

ws -u name -p pass - use a different username and password. This parameters are usefull to build a script.

ws -U on - This parameter is only used in a startup script. -U means the unix username. When loging in, it takes the unix username login automatically, searches the default authfile and automatically mounts the filesystem as configured in ws.conf. This command can be included in /etc/gdm/PostLogin/Default (or /etc/X11/gdm/PostLogin/default ). To unmount the shares when loging out, the comand ws -f off must be included in /etc/gdm/PostSession/Default. A command named ws-auto on can be used to automate the inclusion of those commands. ws-auto off delete these commands from those files. This command may not work in some distributions.  

SEE ALSO

AUTHOR

REPORTING BUGS

COPYING

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

AUTHOR

REPORTING BUGS

COPYING