"Fossies" - the Fresh Open Source Software Archive

Member "smbnetfs-0.6.3/doc/ENGLISH.FAQ" (23 Dec 2013, 7227 Bytes) of package /linux/misc/smbnetfs-0.6.3.tar.bz2:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 List of questions:
    2 ================
    3 Q1: What about errors and memory leaks in libsmbclient library ?
    4 Q2: Is where any similar program on the web ?
    5 Q3: How can I setup a correct working/listing of the files and directories
    6     with national characters ?
    7 Q4: It's takes a lot of time for KDE (gnome terminal) to show
    8     group/computers/shares list. What can I do for it ?
    9 Q5: I have a problem, what should I do ?
   10 
   11 QUESTIONS AND ANSWERS
   12 ================
   13 
   14 Q1: What about errors and memory leaks in libsmbclient library ?
   15 
   16 A1: Starting from SMBNetFS-0.5.0 all interaction with libsmbclient library
   17     moved to separate processes (which can be relatively safe killed). So the
   18     problems in libsmbclient do not lead to any unpleasant consequences
   19     to SMBNetFS or your computer anymore.
   20 
   21 ----------------------------------------------------------------------------
   22 
   23 Q2: Is where any similar program on the web ?
   24 
   25 A2: Yes, here is a list.
   26 
   27     1) KDE, GNOME, Xfce.
   28 
   29     2) fusesmb -- http://hannibal.lr-s.tudelft.nl/fusesmb/
   30 
   31        SMB for FUSE is a Network Neighborhood (Samba shares) filesystem.
   32        It works like smbfs, but instead of accessing one share at a time,
   33        all computers and workgroups are accessible at once from a single
   34        filesystem mount, making network browsing just as easy as it is on
   35        Windows.
   36 
   37     3) fusemb -- http://yarick.territory.ru/fusemb
   38 
   39        fusemb is an SMB network Unix filesystem hierarchy interconnector 
   40        using the fuse filesystem in user space.
   41 
   42     4) smbc -- http://smbc.airm.net
   43 
   44        Samba Commander is a text mode SMB network commander. In SMBC, you
   45        can browse the local network or you can use the search function to
   46        find the files. You can also download/upload files and directories
   47        or create them both locally and remotely. SMBC has a resume function,
   48        supports UTF-8 characters, and is multilingual.
   49 
   50     5) xsmbrowser -- http://www.public.iastate.edu/~chadspen/
   51 
   52        xSMBrowser is a tool for navigating SMB Networks (Samba, SMB, CIFS).
   53        It retains the features of the program it was based upon (Microsoft's
   54        Network Neighborhood), but adds convenient features for Unix users.
   55        These include mounting, ability to change networks on-the-fly, and
   56        conveniences such as a Stop Button.
   57 
   58     6) smb4k -- http://smb4k.berlios.de/
   59 
   60        Smb4K is a SMB/CIFS share browser for KDE. It uses the Samba software
   61        suite to access the SMB/CIFS shares of the local network neighborhood.
   62        Its purpose is to provide a program that's easy to use and has as many
   63        features as possible.
   64 
   65 ----------------------------------------------------------------------------
   66 
   67 Q3: How can I setup a correct working/listing of the files and directories
   68     with national characters ?
   69 
   70 A3: In most cases SMBNetFS will work correctly just out of the box, but if
   71     something goes wrong here is a short instruction. Replace the word CHARSET
   72     with the your local charset and the word DOS_CHARSET with OEM charset
   73     (also known as DOS charset) used by Windows in your country. You can find
   74     your local charset in the output of locale command (in the most cases
   75     it will be UTF-8).
   76 
   77    (RECOMMENDED)
   78    =============
   79 
   80      1) Copy file "/etc/samba/smb.conf" to "~/.smb" directory (if there is no
   81         such directory, then it should be created first).
   82 
   83 	  mkdir -p ~/.smb
   84 	  cp /etc/samba/smb.conf ~/.smb/smb.conf
   85 
   86      2) Find and replace the values of “unix charset”, “display charset” and
   87         “dos charset” in the file “~/.smb/smb.conf” according to values shown
   88         below (if there are no such lines in the file, then it should be
   89         created).
   90 
   91 	  unix charset = utf-8
   92 	  display charset = utf-8
   93 	  dos charset = DOS_CHARSET
   94 
   95      3) The file “~/.smb/smbnetfs.conf” should contain the following lines
   96         (if there are no such lines in the file, then it should be created).
   97 
   98 	  samba_charset  "utf-8"
   99 	  local_charset  "CHARSET"
  100 
  101    --------------------------------------------------------------
  102 
  103    (NOT RECOMMENDED)
  104    =================
  105 
  106      There is another way of configuring SMBNetFS. In this case libsmbclient
  107      will use your local charset. As result you can't work with the files that
  108      contains characters which have no equivalent in your local charset.
  109 
  110      1) Copy file "/etc/samba/smb.conf" to "~/.smb" directory (if there is no
  111         such directory, then it should be created first).
  112 
  113 	  mkdir -p ~/.smb
  114 	  cp /etc/samba/smb.conf ~/.smb/smb.conf
  115 
  116      2) Find and replace the values of “unix charset”, “display charset” and
  117         “dos charset” in the file “~/.smb/smb.conf” according to values shown
  118         below (if there are no such lines in the file, then it should be
  119         created).
  120 
  121 	  unix charset = LOCALE
  122 	  display charset = LOCALE
  123 	  dos charset = DOS_CHARSET
  124 
  125      3) The file “~/.smb/smbnetfs.conf” should contain the following lines
  126         (if there are no such lines in the file, then it should be created).
  127 
  128 	  samba_charset  "LOCALE"
  129 	  local_charset  "LOCALE"
  130 
  131    --------------------------------------------------------------
  132 
  133    (NOT RECOMMENDED)
  134    =================
  135 
  136      There is a third way. You can use the internal encoding conversion of
  137      libfuse library (require libfuse >= 2.5). In this case you will have the
  138      same issue as above (you can't work with the files that contains
  139      characters which have no equivalent in your local charset) and also you
  140      may not see the samba shares that have national characters in their names.
  141 
  142      Just run SMBNetFS with the following command (it is assumed here what
  143      libsmbclient use SAMBA_CHARSET for their work)
  144 
  145 	  smbnetfs -o modules=iconv,from_code=SAMBA_CHARSET,to_code=CHARSET mountpoint
  146 
  147 ----------------------------------------------------------------------------
  148 
  149 Q4: It's takes a lot of time for KDE (gnome terminal) to show
  150     group/computers/shares list. What can I do for it ?
  151 
  152 A4: It's most likely that the problem can be solved with the help of
  153     “stat_workaround_depth” configuration parameter (read the detailed
  154     description in conf/smbnetfs.conf file of SMBNetFS distribution).
  155 
  156     In short: try to setup “stat_workaround_depth” to the value of 3 or above.
  157 
  158 ---------------------------------------------------------------------------
  159 
  160 Q5: I have a problem, what should I do ?
  161 
  162 A5: It's quite often that the cause of errors is the samba and/or SMBNetFS
  163     misconfiguration. To understand the cause of the error, set the value of
  164     “smbnetfs_debug”  to 5, 6 or 7 (also it maybe useful to setup
  165     “smb_query_browsers” to false) and run “smbnetfs” with an additional
  166     option "-d". Repeat your steps to reproduce the error. Examine the debug
  167     information and try to fix the error by yourself. If it does not help,
  168     try to contact with the author (please do not forget the debug output).
  169 
  170     Examples of collecting debug  information:
  171 
  172 	  smbnetfs -d -o smbnetfs_debug=7 mountpoint  | tee -o smbnetfs.log
  173 	  smbnetfs -d -o smbnetfs_debug=7,smb_query_browsers=false mountpoint  | tee -o smbnetfs.log
  174 
  175 ---------------------------------------------------------------------------