File: INSTALL

package info (click to toggle)
obexpushd 0.11.2-6
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 636 kB
  • sloc: ansic: 6,758; xml: 482; sh: 81; makefile: 6
file content (109 lines) | stat: -rw-r--r-- 3,032 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
Requirements:
=============

You need the development files for:
openobex [>= 1.1 required, >= 1.5 recommended]
bluez-lib

You also must have installed:
cmake [>= 2.6.3]

Optionally you may also install:
pkg-config (to find libraries more easily)
xsltproc or saxon-6.5.x or xalan-2.x (to build documentation)
Docbook XSL files (or the online catalogs will be used)
TCP-Wrapper (to restrict TCP connections)

Building:
=========

CMake is used for building. In the simplest form, you create a binary directory
somewhere e.g. as ./build, change to that directory and run:
$ cmake ..

where ".." is the relative path to the source directory.
If you want to change the installation location to "/usr", define the cmake
variable CMAKE_INSTALL_PREFIX with the -D command line option:
$ cmake -DCMAKE_INSTALL_PREFIX=/usr ..

You can also use one of the provided interactive front-ends:
$ ccmake ..
or
$ cmake-gui ..

as replacement for the cmake calls above (see documentation of ccmake).

This will create Makefiles and thus you can build the software:
$ make


Build options:
==============

Build options are set with CMake variables by adding -DFOO=bar to the cmake
command line ot set variable 'FOO' to the value 'var'.
Boolean values take the values 'ON' or 'OFF'.

The following build options are available:
USE_SPAWN
    Use POSIX function spawn() (instead of fork()+exec()) for external scripts.
    The default is ON and this is also the suggested value.

USE_THREADS
    Use POSIX threads (instead of fork()) for client connections. The default is
    ON and this is also the suggested value.

ENABLE_TCPWRAP
    Enable support for the tcp wrapper (see /etc/host.deny and /etc/hosts.allow)

BUILD_HELP_HTML
    Build the HTML help files. Default is OFF.

BUILD_HELP_MAN
    Build the manpage files. Default is ON

BUILD_X_OBEX_SHARED_LIBS
    Build libraries to handle x-obex/* mime types in your own programs. Default
    if OFF and the x-obex binaries are linked statically.

DOCBOOK_XSLT_PROCESSOR
    Choose the XSLT processor to use for creating of the help file. Supported
    are xsltproc, saxon-6.5.x and xalan-2.x. The default is set automatically
    from the list of installed ones.

DOCUMENTATION_INSTALL_DIR
    Choose the location where documentation gets installed (example, html help
    files, ...). Defaults to share/doc/obexpushd.

MANPAGE_INSTALL_DIR
    Choose the location where manual pages get installed.
    Defaults to share/man.

There are lots of other variables that affect the build.


Installing:
===========

Run:
$ make install

You can optionally define the DESTDIR variable like
$ make install DESTDIR=/path/to/some/dir


Using:
======

See "obexpushd -h" for help and take a look at the README file.
There is also a manpage.


Specification documents:
========================

You can download the spefication document from:
http://www.bluetooth.com/English/Technology/Building/Pages/Specification.aspx

The OBEX base secification is available seperately from the Infrared Data
Association.