source: trunk/guitools/evfsgui/evfsi_en.ipf@ 652

:userdoc.:title.Samba Client GUI Online Help
:docprof toc=123.
.***************************************************
.*** IPF-Generator Version 0.82 for Framework IV ***
.***************************************************

:h1 res=100 name=concepts.Concepts

:font facename='Default' size=0x0.The eComStation Virtual File System for SMB (EVFS) includes the
following concepts&colon. 
:dl break=fit tsize=16.
:dt.:hp2.Virtual drive
:dd.:ehp2.A volume (represented by a drive letter) under which resources
may be mounted (see below). They are seen as network volumes by
the operating system.
:p.The functionality of the virtual drives is either provided by
EVFS (comes with eComStation) or by Netdrive (Shareware).

:dt.:hp2.Mount point
:dd.:ehp2.A directory on a virtual drive under which SMB network shares may
be mounted. A virtual drive may contain any number of mount
points; mount points may also be created inside other mount
points (just like a normal directory hierarchy). 

:dt.:hp2.Resources:ehp2. 
:dd.Remote CIFS&slr.SMB directory shares which are connected (or
mounted) to a mount point. The mount point may be the drive's
root directory&comma. or any subdirectory. 

:p.Multiple resources may be mounted to a single mount point. This
is not generally recommended&comma. as it can make keeping track
of different resources somewhat confusing. 
:edl.
:p.:hp2.Note:ehp2.&colon. Both EVFS and Netdrive support file&slr.directory
shares only. Network printers are not supported. There are
however other tools to accomplish this task.

:p.:hp2.Additional note to Netdrive:ehp2.&colon. EVFSGUI only support the
CIFS&slr.SMB Netdrive Plugin&comma. but not other plugin
types&comma. such as local&comma. FTP&comma. DAV. Supporting
other plugins in EVFSGUI for Netdrive is under consideration.

:h1 res=200 name=menubar.Main menu

:font facename='Default' size=0x0.The main menu has the following structure&colon.

:p.:hp2.File&colon. The file menu holds items for several file oriented
tasks&colon.

:p.Load:ehp2.&colon. Loads a previously saved profile file and restores
connections from it..

:p.:hp2.Save:ehp2.&colon. Saves all current connections&comma. both active and
passive ones to a profile file (a plain text file with the
extension of .evp or .ndc).

:p.:hp2.Autostart:ehp2.&colon. Creates an object in the startup folder&comma.
which loads a previously stored profile file and restores its
connections automatically during startup.

:p.:hp2.Global Settings:ehp2.&colon. Opens the dialog to configure :link reftype=hd refid=settings.global
program settings:elink..

:p.:hp2.Advanced Mount Options:ehp2.&colon. Opens the dialog with the :link reftype=hd refid=current.advanced
mount options:elink..

:p.:hp2.Close:ehp2.&colon. Saves settings and closes the graphical user
interface.

:p.:hp2.Edit:ehp2.&colon. Corresponds with the context menu of the left panel
(Current connections).

:p.:hp2.View:ehp2.&colon. Allows you to select the different views of the
program.

:p.:hp2.Selected:ehp2.&colon. Corresponds with the context menu of the right
panel (Network neighbourhood&comma. connection details or dialog
view).

:p.:hp2.Help:ehp2.&colon. Displays the online help for the main window.

:h1 res=300 name=commandline.Commandline switches

:font facename='Default' size=0x0.EVFSGUI recognizes the following command line parameters&colon.
:dl break=fit tsize=16.
:dt.:hp2.-ndfs:ehp2.&colon.
:dd.EVFSGUI works both with EVFS&comma. the eComStation Virtual
Filesystem for CIFS&slr.SMB&comma. as well as with Netdrive. EVFS
is a modified version of Netdrive&comma. which only supports
CIFS&slr.SMB plugin (ndpsmb.dll).

:p.In addition to EVFS&comma. EVFSGUI can also be used with the full
version of Netdrive.EVFSGUI will auutomatically detect&comma.
which of the  two versions are installed.

:p.If both are installed&comma. is EVFS takes precedence. Using the
the -ndfs switch&comma. usage of Netdrive over EVFS can be
enforced..
:edl.
:p.The startup mechanism additionally uses the following commandline
switches&colon.
:dl break=fit tsize=16.
:dt.:hp2.Profile file:ehp2.&colon.
:dd.Load the file with the extension .evp for EVFS&comma.
respectively .ndc for Netdrive to restore all connections.

:p.A profile file can also be also be dragged and dropped on the
left panel to establish the appropriate connections.

:dt.:hp2.-nogui:ehp2.&colon. 
:dd.Displays only a small status window.

:dt.:hp2.-auto-close:ehp2.&colon. 
:dd.Closes EVFSGUI again after 3 seconds.

:dt.:hp2.-delay [n]&colon. 
:dd.:ehp2.Wait for n seconds before restoring connections. 60 seconds by
default.

:edl.

:h1 res=400 name=main.The main window

:font facename='Default' size=0x0.The eComStation Virtual File System for SMB (EVFS) is a network client 
based on Samba and NetDrive. It is designed to allow easy access to shared 
files and directories on SMB-based local area networks. 
Information about the basic concepts of EVFS is available here. 

:p.The EVFS Graphical User Interface (EVFSGUI) is a simple user interface to EVFS. This page describes the main window of EVFSGUI and its views.
:ul.
:li.:link reftype=hd refid=current.Current connections:elink.
:li.:link reftype=hd refid=dialog.Dialog:elink.
:li.:link reftype=hd refid=smbtree.Network neighbourhood:elink.
:li.:link reftype=hd refid=condet.Connection details:elink.
:eul.

:h2 res=420 name=current.Current connections

:font facename='Default' size=0x0.The Current Resources panel&comma. on the left-hand side of the
window&comma. shows all the EVFS virtual drives and mount points
which are currently attached&comma. and the resources (if any)
which are mounted to them. These are shown in the container
control which occupies most of this panel.

:p.Below the container there are two buttons&colon.
:dl break=fit tsize=16.
:dt.:hp2.Detach:ehp2. 
:dd.This button removes (or detaches) the currently-selected virtual
drive. This unmounts all resources mounted under that drive
(including those connected to child mount points)&comma. deletes
all mount points on the drive&comma. and removes the drive letter
from the operating system. 

:dt.:hp2.Unmount:ehp2. 
:dd.This button disconnects (or unmounts) any resource(s) which are
currently mounted to the selected mount point. 

:p.If the selected mount point has any child mount points under
it&comma. they will not be affected. 

:p.If it has no child mount points under it&comma. then the selected
mount point will also be deleted - unless it is the root
directory of the drive itself. 
:edl.
:p.Right clicking on a mount point brings up a context menu&comma.
which provides the same functionality as the buttons below the
container.

:h2 res=430 name=dialog.Dialog

:font facename='Default' size=0x0.The New Resource panel&comma. on the right-hand side&comma.
allows you to mount a new resource in a conveniant dialog.

:p.:hp2.Mount:ehp2. 
:p.Indicates the number and type of resources you want to mount. 

:p.:hp2.Single share:ehp2. 
:p.The simplest type of connection&colon. the specified share is
mounted. The server and share names must be specified; the
workgroup is optional. 

:p.:hp2.All shares on server:ehp2. 
:p.All shares on the specified server are mounted. Each share
appears as a subdirectory under the mount point. The server name
must be specified; the workgroup is optional. 

:p.:hp2.All servers on workgroup:ehp2. 
:p.All servers in the specified workgroup are mounted. Each server
appears as a subdirectory under the mount point&comma. with its
shares as subdirectories below that. The workgroup name must be
specified. 

:p.:hp2.All available workgroups:ehp2. 
:p.All workgroups in a network are mounted. Each workgroup appears
as a subdirectory under the mount point. The master browser
(either a server or a workgroup) for the network must be
specified. 

:p.:hp2.Server:ehp2. 
:p.The CIFS&slr.SMB (NetBIOS) name of the server you want to connect
to&comma. if applicable. 

:p.:hp2.Share:ehp2. 
:p.The name of the share (on the specified server) which will be
mounted&comma. when 'single share' is selected (above). 

:p.:hp2.Workgroup:ehp2. 
:p.The name of the LAN workgroup or domain to which the connection
will be established. This is optional&comma. unless 'all servers
in workgroup' is selected (above). 

:p.:hp2.Master Browser:ehp2. 
:p.This option is only available if 'all available workgroups' is
selected (above). In this case&comma. the name of the server or
workgroup that acts as a master browser for the network being
accessed should be specified in the entryfield. 

:p.The checkbox below the entryfield indicates whether the entered
name is that of a server or a workgroup. 

:p.:hp2.Advanced:ehp2. 
:p.This button brings up the Advanced Mount Options dialog. This one
is also available using the file menu.

:p.:hp2.User ID:ehp2. 
:p.Enter the user ID that will be used to access the mounted
resource. If left blank&comma. a default user ID of 'guest' will
be used. 

:p.:hp2.Password:ehp2. 
:p.Enter the password for the specified user ID. If left
blank&comma. a null password ('') will be used. 

:p.:hp2.Mount to:ehp2. 
:p.Specifies desired mount point&colon. that is&comma. the virtual
drive and (optional) subdirectory to which the resource will be
mounted. 

:p.If the selected virtual drive does not exist already&comma. it
will be attached automatically. If a subdirectory is
specified&comma. it will be created automatically if it does not
exist already. 

:p.:hp2.Mount:ehp2. 
:p.Use this button to mount the resource once the required fields
have been filled in.

:h2 res=440 name=smbtree.Network neighbourhood

:p.:font facename='Default' size=0x0.The Network Neighbourhood View shows available LAN workgroups
(domains)&comma. server or its shares.

:p.Using either the context menu or drag and drop operations you can
create new  connections.

:h2 res=450 name=condet.Connection details

:p.:font facename='Default' size=0x0.Connection Details View shows the properties of all
connections&comma. both active and passive ones.

:p.Using either the context menu or drag and drop operations you can
activate or restore passive connections.

:h1 res=500 name=miniicons.Mini icons

:font facename='Default' size=0x0.Using this option you can switch between big and small icons.

:h1 res=600 name=buttons.Buttons on the main window

:font facename='Default' size=0x0.The (optional) Buttons on the main window correspond with the
menu items of the File menu and the Help menu of the  :link reftype=hd refid=menubar.main menu:elink..

:h1 res=700 name=advanced.Advanced mount options

:font facename='Default' size=0x0.This window contains the following options&colon. 

:p.:hp2.Support extended attributes:ehp2. 
:p.Specifies whether or not the mounted resource should support
OS&slr.2 extended attributes (EAs). 

:p.:hp2.Mount read-only:ehp2. 
:p.Specifies whether or not the resource should be mounted in
read-only mode. 

:p.:hp2.Create mountpoint even when connection attempt fails
:p.:ehp2.When enabled&comma. a mountpoint that was created during an
failed connection attempt is preserved. Normally&comma. it is
removed in this case.

:p.:hp2.Cache timeout
:p.:ehp2.The time in seconds for which the cache is valid. If the time is
over the client rereads the directory again. For a directory with
many files&comma. it may be better to increase the timeout (rule
of thumb&colon. per 500-800 files 10 seconds). 
:p.Default&colon. 10 seconds.

:p.:hp2.Cache listings
:p.:ehp2.The amount of directories the cache should hold. Be aware the
higher the value the more memory will be used. 
:p.Default&colon. 32 listings.

:p.:hp2.No. of 64 kB blocks (only Version 1.x)
:p.:ehp2.This allows you to set the size of the shared memory buffer which
is allocated for every connection. Higher values may provide
improved access speed&comma. but at a cost of using up more
system memory. 

:p.The OK button will save any changes and close the window. The
Cancel button will close the window without making any changes. 

:p.Note&colon. Options set using this window be used for all
subsequent mount operations initiated from the New Resource
panel&comma. until you exit the program. However&comma. they will
return to the default values the next time you start EVFSGUI. 

:h1 res=800 name=settings.Global settings

:font facename='Default' size=0x0.The following global settings can be set for the program&colon.

:p.:hp2.Authenticate for browsing:ehp2.&colon.

:p.Normally&comma. the program uses the privileges of the Guest
account in order to browse the networkneighbourhood. If this
option is set&comma. the user is asked for his username and
password before the updating the network neighbourhood. Depending
upon the permissions of the used account&comma. more machines and
shares can be displayed.

:p.:hp2.Immediate Network Neighborhood update:ehp2.&colon.

The network neighborhood must be updated manually by selecting
the appropriate button by default. Setting this option&comma. the
update is done automatically during the start of the program.

:p.:hp2.Use broadcasts instead of Local Master Browser:ehp2.&colon.

Query network nodes by sending requests as broadcasts instead of
querying the local master browser.

:p.:hp2.Save inactive connections:ehp2.&colon.

:p.With this option enabled&comma. the program also keeps track of
connections that cannot currently be reestablished.

:p.:hp2.Enable plugin logging:ehp2.&colon.

:p.The CIFS&slr.SMB plugin for EVFS (or Netdrive) has a built-in
logging feature. To produce a logfile&comma. you must put an
empty file named ndpsmb.dbg into the root directory of the
bootdrive. This option creates this file or removes it again.

The logfiles log.ndpsmb and log.smbc are stored in path of the
LOGFILES environment variable. In case this does not exist&comma.
the file is placed into the EVFS (Netdrive) directory.

:p.:hp2.Debug:ehp2.&colon.

This option opens a console in which you can observe what the
program does at the moment.

:h1 res=900 name=about.Product information

:font facename='Default' size=0x0.eComStation Virtual File System for SMB Graphical User Interface 
(EVFSGUI)

:p.Version 2.1 (January&comma. 2011)

:p.(c) 2009-2011 Herwig Bauernfeind&comma. parts also (c) 2007-2009
Alex Taylor. All rights reserved.

:p.Permission to use&comma. modify&comma. and&slr.or distribute
EVFSGUI&comma. for commercial purposes or otherwise&comma. is
granted to Serenity Systems International and Mensys BV.

:p.:hp2.Additional Resources

:p.:ehp2.Samba server and resources&colon.
http&colon.&slr.&slr.svn.netlabs.org&slr.samba 
:p.Problem reports&colon.
http&colon.&slr.&slr.svn.netlabs.org&slr.samba&slr.report 
:p.Samba home page&colon. http&colon.&slr.&slr.www.samba.org 
:p.NetDrive home page&colon.
http&colon.&slr.&slr.www.blueprintsoftwareworks.com&slr.netdrive&slr. 



:euserdoc.