summaryrefslogtreecommitdiffstats
path: root/api/examples/README
diff options
context:
space:
mode:
authorAnand Avati <avati@redhat.com>2012-07-12 15:40:43 -0700
committerAnand Avati <avati@redhat.com>2012-07-18 12:12:25 -0700
commitb324e317311974fbbb9ba13548364213a7a7a41a (patch)
treea0e7241d7bf12a4304d7b3819859aa273b614fa8 /api/examples/README
parentdbd7aa2d6b4128faa771d616c429b3a315740cec (diff)
glfsxmp: libgfapi based example
This is an example application which uses libgfapi. It is a complete autotools based build system which demonstrates the required changes in configure.ac, Makefile.am etc to successfuly detect for and build an application against libgfapi. There are two approaches to building a libgfapi based application: 1. In the presence of pkg-config in your build system. This is the recommended approach which is also used in this example. For this approach to work, you need to build glusterfs by passing --pkgconfigdir=/usr/lib64/pkgconfig (or the appropriate directory) in your distro. This already happens if you build RPMs with the glusterfs.spec provided in glusterfs.git. You will also need to install glusterfs-api RPM. 2. In the absence of pkg-config in your build system. Make sure your LDFLAGS includes -L/path/to/lib where libgfapi.so is installed and -I/path/to/include/glusterfs where the 'api' directory Change-Id: Ic4eab2df002d7e8d20593a03e643859423048848 BUG: 839950 Signed-off-by: Anand Avati <avati@redhat.com> Reviewed-on: http://review.gluster.com/3666 Tested-by: Gluster Build System <jenkins@build.gluster.com> Reviewed-by: Amar Tumballi <amarts@redhat.com>
Diffstat (limited to 'api/examples/README')
-rw-r--r--api/examples/README19
1 files changed, 19 insertions, 0 deletions
diff --git a/api/examples/README b/api/examples/README
new file mode 100644
index 000000000..8f0bab697
--- /dev/null
+++ b/api/examples/README
@@ -0,0 +1,19 @@
+This is an example application which uses libgfapi. It is
+a complete autotools based build system which demonstrates the
+required changes in configure.ac, Makefile.am etc to successfuly
+detect for and build an application against libgfapi.
+
+There are two approaches to building a libgfapi based application:
+
+1. In the presence of pkg-config in your build system.
+This is the recommended approach which is also used in this example.
+For this approach to work, you need to build glusterfs by passing
+--pkgconfigdir=/usr/lib64/pkgconfig (or the appropriate directory)
+in your distro. This already happens if you build RPMs with the
+glusterfs.spec provided in glusterfs.git. You will also need to
+install glusterfs-api RPM.
+
+2. In the absence of pkg-config in your build system.
+Make sure your LDFLAGS includes -L/path/to/lib where libgfapi.so is
+installed and -I/path/to/include/glusterfs where the 'api' directory
+containing the headers are available.