File: README

package info (click to toggle)
rrdtool 1.9.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 4,772 kB
  • sloc: ansic: 39,371; sh: 1,810; perl: 1,268; cs: 652; makefile: 573; python: 169; ruby: 61; awk: 30
file content (68 lines) | stat: -rw-r--r-- 2,424 bytes parent folder | download | duplicates (9)
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
RRDLua is a Lua module for RRD functions.

- Configuration

  From the top dir of RRDtool package, run "./configure", or
  "./configure --enable-lua-site-install" if you prefer to install in
  Lua's search path.

 You should have lua 5.0, or superior, and respective lua-dev packages
 installed before executing configure.

- Compilation and installation

 Run 'make' and 'sudo make install'. If you don't enable lua-site-install,
 the Lua modules will be installed together with RRDtool, under the subdir
 <INSTALL_PREFIX>lib/lua/<lua_version>.

- Testing

 Install RRDtool first, as above. Then, enter the bindings/lua dir, run
 'make test' and use your preferred viewer to display the just created
 'test.png'. If you can read "Enjoy Lua RRDtool module!" on the picture,
 everything went fine.

- Using with Lua 5.1

 Start your programs with:

  ------..-----------------------------------------------------------
  package.cpath = '<INSTALL_PREFIX/lib/lua/5.1/?.so;' ..
                  package.cpath
  require 'rrd'
  -------------------------------------------------------------------

 OBS: If you use the option --enable-lua-site-install you won't need
      to change package.cpath like above. 

- Using with Lua 5.0

 The Lua binding for RRDtool needs the compat-5.1 module to work with
 Lua 5.0. Some Linux distros, like Ubuntu gutsy and hardy, have it
 already integrated in Lua 5.0 -dev packages, so you just have to
 require:

  require 'compat-5.1'

 For other platforms, the compat-5.1 module that comes with this Lua
 binding will be installed for you in the same dir where RRDtool was
 installed, under the subdir .../lib/lua/5.0. In this case, you must
 tell your Lua programs where to find it by changing the Lua var
 LUA_PATH:

  --- compat-5.1.lua is only necessary for Lua 5.0 ------------------
  original_LUA_PATH = LUA_PATH
  -- try only compat-5.1 installed with RRDtool package
  LUA_PATH = '<INSTALL_PREFIX>/lib/lua/5.0/?.lua'
  require 'compat-5.1'
  LUA_PATH = original_LUA_PATH
  original_LUA_PATH = nil
  --- end of code to require compat-5.1 -----------------------------

  Now we can require the rrd module just like we did for 5.1 above:

  -------------------------------------------------------------------
  package.cpath = '<INSTALL_PREFIX>/lib/lua/5.0/?.so;' ..
                  package.cpath
  require 'rrd'
  -------------------------------------------------------------------