Beyond Linux® From Scratch - Version 6.3

Chapter 8. General Libraries

GMime-2.2.10

Introduction to GMime

The GMime package contains a set of utilities for parsing and creating messages using the Multipurpose Internet Mail Extension (MIME) as defined by the applicable RFCs. See the GMime web site for the RFCs resourced. This is useful as it provides an API which adheres to the MIME specification as closely as possible while also providing programmers with an extremely easy to use interface to the API functions.

Package Information

GMime Dependencies

Required

GLib-2.12.12

Optional

GTK-Doc-1.8 and Gtk# (requires Mono)

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gmime

Installation of GMime

Install GMime by running the following commands: 

./configure --prefix=/usr &&
make

If you have DocBook-utils-0.6.14 installed and you wish to generate the API tutorials, issue the following commands: 

cd docs/tutorial &&
docbook2html --nochunks gmime-tut.sgml &&
docbook2pdf             gmime-tut.sgml &&
docbook2ps              gmime-tut.sgml &&
docbook2txt             gmime-tut.sgml &&
cd ../..

To test the results, issue make check. Note that some tests may fail because the corresponding sub-system is not installed or configured properly.

This package will overwrite the uudecode and uuencode programs installed by the sharutils package (or any other package that may install these programs) if they exist in /usr/bin. If you wish to preserve the existing programs, ensure you rename them before issuing the following commands.

Now, as the root user: 

make install &&
install -v -m755 -d /usr/share/doc/gmime-2.2.10 &&
install -v -m644 README docs{,/tutorial}/gmime* \
                    /usr/share/doc/gmime-2.2.10

Command Explanations

--enable-gtk-doc: Use this parameter if GTK-Doc is installed and you wish to rebuild the API documentation.

Contents

Installed Programs: gmime-config, uudecode and uuencode
Installed Libraries: libgmime-2.0.{so,a} and optionally, Mono bindings
Installed Directories: /usr/include/gmime-2.0, /usr/lib/mono/gac/gmime-sharp, /usr/lib/mono/gmime-sharp, /usr/share/doc/gmime-2.2.10 and /usr/share/gtk-doc/html/gmime

Short Descriptions

gmime-config

is used to gather information about how and where GMime was installed. It is typically used by other programs seeking to link to the GMime library.

uudecode

is used to decode files or data encoded with uuencode.

uuencode

is a method of encoding binary data into 7-bit ASCII data.

libgmime-2.0.{so,a}

contains API functions used by programs that need to adhere to the MIME standards.

Last updated on 2007-07-20 15:41:06 -0500