new README.linux

merge-requests/1/head
Rolf Bensch 2012-12-13 10:58:51 +01:00
rodzic 1e0485d029
commit 15e085c08d
1 zmienionych plików z 144 dodań i 131 usunięć

Wyświetl plik

@ -45,6 +45,150 @@ Gentoo information:
Gentoo users: If your USB scanner is not detected at all check that USE=usb is
set when emerging.
Quick install:
--------------
$ ./configure
$ make
$ make install
Step by step install on Linux 2.6.* and 3.*, both with udev:
------------------------------------------------------------
1. Install missing development packages with your prefered package manager:
- libusb-dev
2. Get the latest SANE backend from git:
You can download daily git snapshot from here:
http://www.sane-project.org/snapshots/
If you prefer to use git, you can fetch a read-only copy of the git tree
with this command:
$ git clone git://git.debian.org/sane/sane-backends.git
If you already are using a self compiled SANE backend and just fetched a
new copy of the git tree or if you patched some source files, there is no
need to follow the installation procedure again. You only need to make and
install libsane:
$ make && sudo make install
3. Search the location where your system installed libsane:
Each distribution uses different folders for the libraries.
Here are some examples from 64 bit Ubuntu 10.04. For the installation on
your system you need to replace /usr/lib with the folder detected below.
$ sudo find / -name libsane.so.1
/usr/lib/libsane.so.1
/usr/lib is the folder we are looking for.
Be careful on 64 bit systems, if you already installed 32 bit compatibility
libraries, e.g. the package ia32-libs:
$ sudo find / -name libsane.so.1
/usr/lib/libsane.so.1
/usr/lib32/libsane.so.1
This response contains 2 folders:
(1) /usr/lib32 is the location of the 32 bit compatibility libraries.
(2) /usr/lib is the folder we are looking for.
Be careful, if you already compiled and installed new SANE backend:
$ sudo find / -name libsane.so.1
/usr/lib/libsane.so.1
/usr/local/lib/libsane.so.1
/home/user/src/sane-backends/backend/.libs/libsane.so.1
This response contains 3 folders:
(1) /usr/local/lib is the location of installed new SANE backend.
(2) /home/user/src/sane-backends/backend/.libs is the location of
compiled new SANE backend in the source tree.
(3) /usr/lib is the folder we are looking for.
4. Decide where you want to install new libsane:
You don't need to remove your linux distribution's libsane packages, this
may break needed depedencies to other useful packages like xsane.
You should set symbolic links to new libsane. This avoids problems with the
package manager of your Linux distribution.
I assume that new libsane version 1.0.24 will be installed to
/usr/local/lib and your system installed libsane.so.1 to /usr/lib.
You can backup the existing symlinks and files as *.orig.
$ cd /usr/lib
$ sudo mv libsane.so.1 libsane.so.1.orig
$ sudo mv libsane.la libsane.la.orig
$ sudo ln -sf /usr/local/lib/libsane.so.1.0.24 libsane.so.1
$ sudo ln -sf /usr/local/lib/sane/libsane.la libsane.la
$ cd -
Alternatively you can overwrite standard libsane. But then you must pay
attention to your system's upgrades of libsane.
You need to do some extra configuration for latest SANE backend:
$ ./configure --libdir="/usr/lib"
You also can replace the binaries, configuration, manuals, translations,
etc. of your distribution. For more information please read:
$ ./configure --help
5. Configure, make and install latest SANE backend:
$ ./configure [with your options defined above]
$ make && sudo make install
6. Use the scanner with normal user rights:
Copy udev rules file:
$ sudo cp tools/udev/libsane.rules /etc/udev/rules.d
Reconnect your scanner to the USB bus to activate the new rules file.
Your user must be a member of the group scanner:
$ sudo adduser [username] scanner
After this you must logoff and login again.
7. Test your scanner:
First you should check the used libsane version.
$ scanimage -V
scanimage (sane-backends) 1.0.24git; backend version 1.0.24
This example shows that backend and scanimage are version 1.0.24.
$ /usr/bin/scanimage -V
scanimage (sane-backends) 1.0.20; backend version 1.0.24
This example shows that an old scanimage (1.0.20) uses the backend 1.0.24.
If you want to use xsane, start xsane and check the used version with
CTRL - i.
Now you can test if your scanner is recognized with normal user rights.
$ scanimage -L
If your scanner isn't recognised here, try this:
$ sudo scanimage -L
If this works, your user doesn't have the rights to access the
scanner.
However, please check and redo the installation described above.
If this doesn't help, you can ask the mailing list
<sane-devel@lists.alioth.debian.org> for further support.
Information about SCSI scanners:
================================
@ -163,135 +307,4 @@ The Intel C++ Compiler for IA32 and IA64 isn't supported yet. If you want
# include <asm/io.h>
#endif
Installation
============
Get the latest SANE backend from git.
You can download daily git snapshot from here:
http://www.sane-project.org/snapshots/.
If you prefer to use git, you can fetch a read-only copy of the git tree with
this command:
$ git clone git://git.debian.org/sane/sane-backends.git
You need to install SANE backend on a terminal window from inside sane-backends
source folder.
If you already are using a self compiled SANE backend and just fetched a new
copy of the git tree or if you patched some source files, there is no need to
follow the installation procedure again. You only need to make and install
libsane:
$ make && sudo make install
Read the file README and this file.
Install missing development packages with your prefered package manager:
libusb-dev
Search the location where your system installed libsane.so.1.
Each distribution uses different folders for the libraries.
Here are some examples from 64 bit Ubuntu 10.04. For the installation process
you need to replace /usr/lib with the folder detected on your system.
$ sudo find / -name libsane.so.1
/usr/lib/libsane.so.1
/usr/lib is the folder we are looking for.
Be careful on 64 bit systems, if you already installed 32 bit compatibility
libraries, e.g. the package ia32-libs:
$ sudo find / -name libsane.so.1
/usr/lib/libsane.so.1
/usr/lib32/libsane.so.1
This response contains 2 folders: (1) /usr/lib32 is the location of the
32 bit compatibility libraries. (2) /usr/lib is the folder we are looking
for.
Be careful, if you already compiled and installed new SANE backend:
$ sudo find / -name libsane.so.1
/usr/lib/libsane.so.1
/usr/local/lib/libsane.so.1
/home/user/src/sane-backends/backend/.libs/libsane.so.1
This response contains 3 folders: (1) /usr/local/lib is the location of
installed new SANE backend. (2) /home/user/src/sane-backends/backend/.libs
is the location of compiled new SANE backend in the source tree.
(3) /usr/lib is the folder we are looking for.
Decide where you want to install new libsane.
You can set symbolic links to new libsane.
I assume that new libsane version 1.0.23 will be installed to
/usr/local/lib and your system installed libsane.so.1 to /usr/lib.
$ cd /usr/lib
$ sudo ln -sf /usr/local/lib/libsane.so.1.0.23 libsane.so.1
$ sudo ln -sf /usr/local/lib/sane/libsane.la libsane.la
$ cd -
Alternatively you can overwrite standard libsane.
Then you need to do some extra configuration for latest SANE backend:
$ ./configure --libdir="/usr/lib"
You also can replace the binaries, configuration, manuals, translations, etc.
of your distribution. For more information please read:
$ ./configure --help
Configure, make and install latest SANE backend.
$ ./configure [with your options defined above]
$ make && sudo make install
Use the scanner with normal user rights.
This only works if udev is installed. Please note that historically not all
of the distributions have used the same format for the udev rules file.
Copy udev rules file:
$ sudo cp tools/udev/libsane.rules /etc/udev/rules.d
Reconnect your scanner to the USB bus to activate the new rules file.
Your user must be a member of the group scanner. Please use the system tools
to check, if this group exists, if needed create this group and join this
group. After this you must logoff and login again.
Test your scanner.
First you should check if new libsane is used.
$ scanimage -V
scanimage (sane-backends) 1.0.23git; backend version 1.0.23
This example shows that backend and scanimage are version 1.0.23.
$ /usr/bin/scanimage -V
scanimage (sane-backends) 1.0.20; backend version 1.0.23
This example shows that an old scanimage (1.0.20) uses the backend 1.0.23.
If you want to use xsane, start xsane and check the used version with
CTRL - i.
Now you can test if your scanner is recognized with normal user rights.
$ scanimage -L
If your scanner isn't recognized here, try this:
$ sudo scanimage -L
If this works, your user doesn't have the rights to access the scanner.
However, please check and redo the installation steps described above.
If this doesn't help, you can ask the mailing list
<sane-devel@lists.alioth.debian.org> for further support.
Have a lot of fun with the latest SANE backend.