Beyond Linux® From Scratch - Version 2012-01-16

Chapter 8. General Libraries

GMime-2.4.21

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.

This package is known to build using an LFS 7.0 platform but has not been tested.

Package Information

GMime Dependencies

Required

GLib-2.30.1

Optional

DocBook-utils-0.6.14, GTK-Doc-1.18, 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: 

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

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.4.21 &&
install -v -m644    README \
                    /usr/share/doc/gmime-2.4.21

If you generated the API tutorials, still as the root user: 

install -v -m644    docs/tutorial/gmime* \
                    /usr/share/doc/gmime-2.4.21

Command Explanations

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

Contents

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

Short Descriptions

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.4.{so,a}

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

Last updated on 2012-01-11 00:38:28 +0000