======== How to install the ROHC library on Gentoo ? ======== Follow this procedure in order to install the ROHC library on a [[http://www.gentoo.org/|Gentoo Linux]] system. For other systems, see the [[library-install|generic installation procedure]]. FIXME the gentoo ebuild is not up-to-date FIXME a shelr screencast would be great FIXME upload the ebuild on sunrise ===== Get the ROHC Ebuild ===== The ROHC Ebuild is not in the Gentoo official tree yet. You have to get it from the [[https://bugs.gentoo.org/show_bug.cgi?id=311619|Gentoo bugtracker]]. Download the 3 following files: * rohc-X.Y.X.ebuild = the Ebuild for the ROHC library version X.Y.Z * metadata.xml = the metadata for ebuild of ROHC library * ChangeLog = the changelog for ebuild of ROHC library ===== Install the ROHC Ebuild in a local repository ===== If you do not have a local tree on your Gentoo system yet, alter you portage configuration as follow to tell portage that a local tree is now present in /usr/local/portage/:<code> # echo "PORTDIR_OVERLAY=/usr/local/portage" >> /etc/make.conf</code> Create the local tree and put the 3 ROHC Ebuild files in it:<code> # mkdir -p /usr/local/portage/net-libs/rohc # cp -f $DOWNLOAD_DIR/rohc-X.Y.X.ebuild /usr/local/portage/net-libs/rohc/ # cp -f $DOWNLOAD_DIR/metadata.xml /usr/local/portage/net-libs/rohc/ # cp -f $DOWNLOAD_DIR/ChangeLog /usr/local/portage/net-libs/rohc/</code> Create the manifest of the ROHC Ebuild:<code> # ebuild /usr/local/portage/net-libs/rohc/rohc-X.Y.X.ebuild manifest</code> The above command will download the source archive of the ROHC library and generate the related MD5/SHA checksums. The ROHC Ebuild is now available in your Gentoo system. ===== Keyword the ROHC Ebuild ===== If you are running a stable Gentoo system, you have to keyword the ROHC Ebuild to be able to install it. If you are running a <nowiki>~arch</nowiki> system, go directly to next step. To keyword the ROHC Ebuild, type as root:<code> # echo "net-libs/rohc" > /etc/portage/package.keywords/rohc</code> If you get an error stating that /etc/portage/package.keywords/rohc is not a directory, it means that your system uses a single file for all keywords instead of a directory. Type the following command as root:<code> # echo "net-libs/rohc" >> /etc/portage/package.keywords</code> ===== Install the ROHC library on the system ===== As root, tell portage to install the ROHC Ebuild:<code> # emerge -av net-libs/rohc</code> The following USE flags are available: * debug = Off by default. Enable verbose output in the ROHC library. Do not use it except if you intend to debug or develop the library itself or an application using the library. * doc = Off by default. Generate HTML documentation of the ROHC library API and performance graphs for the ROHC library. The app-doc/doxygen[latex,dot] and sci-visualization/gnuplot dependencies are then required. The documentation is installed in /usr/share/doc/rohc-X.Y.X/. * rtp-bit-type = Off by default. Enable support for non-standard RTP bit type support. The Ebuild supports testing if the "test" feature is enabled in your make.conf or if FEATURES=test is set in the commande line. Testing the ROHC library requires net-libs/libpcap to be installed. ===== What to do next? ===== Once the ROHC library is installed, you may: * generate [[summary#rohc_statistics|compression statistics]] for a recorded stream, * [[summary#rohc_sniffer|test the ROHC library with your local network traffic]], * run the [[iprohc-overview|IP/ROHC tunnel application]] to establish a tunnel with compression capabilities between 2 machines, * [[library-first-application|use the ROHC library in your own program]].