Compiling and installing the software

This file documents the procedure for compiling and installing the HP OfficeJet Linux driver (hpoj) software.

In case of difficulty

If something goes wrong with these instructions, then refer to the separate build details and troubleshooting document for more information.

Checking for other necessary software

Before compiling and installing the hpoj software, make sure the following prerequisite commands and packages are already installed on your system. The indented commands are possible ways to check for their existence, but you may need to make adjustments depending on your system.

Required:
- If building hpoj from source: GNU make, C and C++ compilers, and linker.
```
	make -v
	gmake -v	# If make isn't the GNU version.
	gcc -v
	g++ -v
	ld -v
```
  Note that some distributions don't install development utilities (compilers, etc.) or packages (header files, etc.) by default.
- To run ptal-init: /usr/bin/perl -- Perl version 5 or later.
```
	perl -v
	which perl
```
- To run ptal-cups: /bin/bash -- Bourne-Again SHell.
```
	bash --version
	which bash
```
Recommended:
Needed only to enable specific functionality. If you're compiling hpoj from source, the ./configure script performs its own checks for some (but not all) of these items and disables features which depend on packages that aren't installed.
If you're using a pre-compiled hpoj package that lacks some of these options, then please report this issue to the downstream package maintainer.
- For USB support: an appropriate Linux kernel version, and/or libusb. (libusb may be required for USB support, depending on your system and device model.)
```
	uname -a
	ldconfig -p | grep libusb	# For Linux
	ldconfig -r | grep libusb	# For FreeBSD
```
  If building hpoj from source: also the libusb header files, which might be in a separate package such as libusb-devel.
- For full JetDirect (network-connect) support: an SNMP library, such as the ucd-snmp package. NET-SNMP version 5 is not currently supported, but older versions (or NET-SNMP-5 built with backwards-compatiblity features) should work.
```
	ldconfig -p | grep libsnmp	# For Linux
	ldconfig -r | grep libsnmp	# For FreeBSD
```
  If building hpoj from source: also the SNMP library header files, which might be in a separate package such as ucd-snmp-devel. In addition, if your SNMP library was built with OpenSSL support, then you may need to ensure that the OpenSSL development libraries are installed, which might be in a separate package such as openssl-devel. Look for a library symlink with the name libcrypto.so.
```
	ldconfig -p | grep libcrypto	# For Linux
	ldconfig -r | grep libcrypto	# For FreeBSD
```
- For easiest setup and management of print queues: CUPS (Common Unix Printing System).
```
	http://localhost:631
```
- For the best print quality on most PCL-only or LIDIL-only (non-PostScript) models: hpijs and ghostscript.
```
	hpijs -h
	gs -h
```
  (Due to the complexity of manually installing or upgrading hpijs and configuring the print subsystem to make use of it, you might want to consider installing a distribution that includes it already. However, recent hpijs versions install the necessary PPD files to make setup of CUPS-based printing much easier.)
- For scanning support: SANE (sane-backends and one or more SANE frontend packages, such as sane-frontends or xsane).
```
	which scanimage
	which xscanimage
	which xsane
```
- For photo-card support: mtools.
```
	which mdir
	which mcopy
```
- For xojpanel support: a recent version of the QT library.
```
	ldconfig -p | grep libqt	# For Linux
	ldconfig -r | grep libqt	# For FreeBSD
```
  If building hpoj from source: also the QT header files and meta-object compiler, which might be in a separate package such as qt-devel.
```
	which moc
```

Checking for and uninstalling an old hpoj version

Special care must be taken if some version of hpoj is already installed on your system and you want to upgrade it to the latest version. Some versions of some distributions provide pre-compiled hpoj packages, but possibly for an older hpoj version. Or you may have previously installed an older hpoj version that you built from source or got as a pre-compiled package from somewhere else.

Try the following commands to determessary, and re-run ldconfig to make your changes take effect.

As an alternative to modifying /etc/ld.so.conf, you can set the environment variable LD_LIBRARY_PATH to /usr/local/lib (or wherever the libraries were installed) before running any of the hpoj programs that depend on libptal.so.

Cleaning up from old hpoj versions

If you're upgrading from an older hpoj version, whether released or from CVS, then there may be outdated files on your system. "make install" checks for these under the installation directory and prints a message asking you to delete any that it finds. However, it will not find them if you install into a different directory from previous versions; in this case, it would be a good idea to delete all files installed by the previous version(s).

If you install the hpoj software into separate unique directories for different versions (such as /opt/hpoj-0.90, etc.), then you should also check /etc/ld.so.conf and remove lines that point to old hpoj versions. However, be careful not to delete the line for the current version, or any line specifying a path containing other libraries on your system that you want to continue to be accessible. Run ldconfig (again, as root) to make your changes to this file take effect.

Next steps

Use the Back button on your browser to return to the previous document, or click here to return to the index.

./usr/share/doc/hpoj/html/setup-build.html0000644000000000000000000002532410215041250020654 0ustar rootroot00000000000000 hpoj: Compiling and installing the software

Compiling and installing the software

This file documents the procedure for compiling and installing the HP OfficeJet Linux driver (hpoj) software.

In case of difficulty

If something goes wrong with these instructions, then refer to the separate build details and troubleshooting document for more information.

Checking for other necessary software

Required:
- If building hpoj from source: GNU make, C and C++ compilers, and linker.
```
	make -v
	gmake -v	# If make isn't the GNU version.
	gcc -v
	g++ -v
	ld -v
```
  Note that some distributions don't install development utilities (compilers, etc.) or packages (header files, etc.) by default.
- To run ptal-init: /usr/bin/perl -- Perl version 5 or later.
```
	perl -v
	which perl
```
- To run ptal-cups: /bin/bash -- Bourne-Again SHell.
```
	bash --version
	which bash
```
Recommended:
Needed only to enable specific functionality. If you're compiling hpoj from source, the ./configure script performs its own checks for some (but not all) of these items and disables features which depend on packages that aren't installed.
If you're using a pre-compiled hpoj package that lacks some of these options, then please report this issue to the downstream package maintainer.
- For USB support: an appropriate Linux kernel version, and/or libusb. (libusb may be required for USB support, depending on your system and device model.)
```
	uname -a
	ldconfig -p | grep libusb	# For Linux
	ldconfig -r | grep libusb	# For FreeBSD
```
  If building hpoj from source: also the libusb header files, which might be in a separate package such as libusb-devel.
- For full JetDirect (network-connect) support: an SNMP library, such as the ucd-snmp package. NET-SNMP version 5 is not currently supported, but older versions (or NET-SNMP-5 built with back

Compiling and installing the software

In case of difficulty

Checking for other necessary software

Required:

Recommended:

Checking for and uninstalling an old hpoj version

Cleaning up from old hpoj versions

Next steps

Compiling and installing the software

In case of difficulty

Checking for other necessary software

Required:

Recommended: