forked from agalakhov/captdriver
-
Notifications
You must be signed in to change notification settings - Fork 16
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Use more explicit installation summary
- Loading branch information
Showing
1 changed file
with
24 additions
and
31 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,31 @@ | ||
# Building and Installing captdriver | ||
Building and Installing Captdriver From Git: TL;DR Version | ||
|
||
This software must be manually installed. The steps are fundamentally | ||
as follows: | ||
git clone https://github.com/mounaiban/captdriver.git captdriver | ||
cd captdriver | ||
aclocal | ||
autoconf | ||
automake --add-missing | ||
./configure | ||
make | ||
make ppd | ||
# the following commands must be run with superuser privileges | ||
make install | ||
cp -p /usr/local/bin/rastertocapt $(cups-config --serverbin)/filter/ | ||
lpadmin -p $PRINTER_NAME -v $PRINTER_URI -P $PPD_FILE -E | ||
lpadmin -d $PRINTER_NAME | ||
|
||
1. Clone, download and extract the captdriver source to a designated | ||
directory. | ||
|
||
2. Generate the required build files. | ||
** Notes ** | ||
|
||
3. Run the generated configuration script `./configure` and initiate | ||
the build process with `make`. | ||
The exact installation commands on your system may differ from the | ||
above example. For detailed instructions (and what to use in place of | ||
`$PRINTER_URI`), check out Mounaiban's Captdriver Wiki at: | ||
|
||
4. Install the driver on your operating system. The build process | ||
produces a single binary named `rastertocapt`, which must be | ||
copied to the `filter/` directoy the CUPS directory. | ||
https://github.com/mounaiban/captdriver/wiki/Building-and-Installing-captdriver%3A-A-Unified-Guide | ||
|
||
* *PROTIP*: Reveal the CUPS directory with `cups-config --serverbin` | ||
For security reasons, `rastertocapt` must be approprately locked down | ||
or it will not work; it must be owned by the `root` user | ||
with read-and-execute-only permissions to all other users. Please see | ||
this issue on the original repo for details: | ||
|
||
* *PROTIP*: For security reasons, CUPS will only run filters that | ||
are locked down: owned by the `root` user with read-and-execute-only | ||
permissions to all other users. See this message on | ||
[Issue #7](https://github.com/agalakhov/captdriver/issues/7#issuecomment-604221791) for details. | ||
|
||
5. Compile the PPD file, to introduce your printer to the CUPS | ||
daemon. | ||
|
||
6. Configure the CUPS daemon to use you printer. There are several | ||
ways to achieve this. | ||
|
||
Detailed instructions are not included in this document, as the | ||
exact procedure will vary between operating systems, and depending | ||
on the approach which you take to install the driver. | ||
|
||
For detailed instructions, please see Mounaiban's captdriver Wiki | ||
at https://github.com/mounaiban/captdriver/wiki | ||
|
||
[wiki]: http://github.com/mounaiban/captdriver/wiki "Mounaiban's captdriver Project Wiki." | ||
https://github.com/agalakhov/captdriver/issues/7#issuecomment-604221791 |