← Back to branch summary

~xnox/ubuntu/raring/abi-compliance-checker/dh_acc

« back to all changes in this revision

Viewing changes to INSTALL.txt

  • Committer: Package Import Robot
  • Author(s): Mathieu Malaterre
  • Date: 2012-04-05 15:46:42 UTC
  • mfrom: (1.1.4)
  • Revision ID: package-import@ubuntu.com-20120405154642-p2xlk8yco5w68b9r
Tags: 1.97.3-1
* New upsteam:
 - checks both binary and source-level compatibility issues with C/C++ APIs
* fix lintian warning for the manpage

Show diffs side-by-side

added added

removed removed

Lines of Context:
INSTALL.txt
1
 
 
2
 
Copyright (C) 2009-2010 The Linux Foundation.
3
 
Copyright (C) 2009-2011 Institute for System Programming, RAS.
4
 
Copyright (C) 2011-2012 Nokia Corporation and/or its subsidiary(-ies).
5
 
Copyright (C) 2011-2012 ROSA Laboratory.
6
 
All rights reserved.
7
 
 
8
 
 
9
 
RELEASE INFORMATION
10
 
 
11
 
Project:           ABI Compliance Checker (ACC)
12
 
Version:           1.96.8
13
 
Date:              2012-02-17
14
 
 
15
 
 
16
 
This INSTALL.txt file explains how to install and setup environment
17
 
for ACC tool in your computer.
18
 
 
19
 
 
20
 
Content:
21
 
 
22
 
   1. Requirements for Linux and FreeBSD
23
 
   2. Requirements for Mac OS X
24
 
   3. Requirements for MS Windows
25
 
   4. Configuring and Installing for Linux and FreeBSD
26
 
   5. Running the Tool
27
 
 
28
 
 
29
 
1. REQUIREMENTS FOR LINUX AND FREEBSD
30
 
=====================================
31
 
 
32
 
   1. G++ (3.0-4.6.2, recommended >= 4.5)
33
 
   2. GNU Binutils (c++filt, readelf, objdump)
34
 
   3. Perl 5 (5.8-5.14)
35
 
 
36
 
 
37
 
 
38
 
2. REQUIREMENTS FOR MAC OS X
39
 
============================
40
 
 
41
 
   Xcode (g++, c++filt, otool)
42
 
 
43
 
 
44
 
 
45
 
3. REQUIREMENTS FOR MS WINDOWS
46
 
==============================
47
 
 
48
 
   1. MinGW (3.0-4.6.2, recommended >= 4.5)
49
 
   2. MS Visual C++ (dumpbin, undname, cl)
50
 
   3. Active Perl 5 (5.8-5.14)
51
 
   4. Sigcheck v1.71 or newer
52
 
   5. Info-ZIP 3.0 (zip, unzip)
53
 
 
54
 
3.1 Setup environment
55
 
 
56
 
   1. Add path to g++.exe (C:\MinGW\bin\) to your system PATH variable
57
 
   2. Run vsvars32.bat script (C:\Microsoft Visual Studio 9.0\Common7\Tools\)
58
 
 
59
 
 
60
 
 
61
 
4. CONFIGURING AND INSTALLING FOR LINUX AND FREEBSD
62
 
===================================================
63
 
 
64
 
   This command will install an abi-compliance-checker program in the
65
 
   PREFIX/bin system directory and private modules into the PREFIX/share:
66
 
 
67
 
     sudo perl Makefile.pl -install --prefix=PREFIX [/usr, /usr/local, ...]
68
 
 
69
 
4.1 Update
70
 
 
71
 
     sudo perl Makefile.pl -update --prefix=PREFIX
72
 
 
73
 
4.2 Remove
74
 
 
75
 
     sudo perl Makefile.pl -remove --prefix=PREFIX
76
 
 
77
 
 
78
 
 
79
 
5. RUNNING THE TOOL
80
 
===================
81
 
 
82
 
   1. Create XML-descriptors for two versions
83
 
      of a library (OLD.xml and NEW.xml):
84
 
 
85
 
            <version>
86
 
                1.0
87
 
            </version>
88
 
 
89
 
            <headers>
90
 
                /path1/to/header(s)/
91
 
                /path2/to/header(s)/
92
 
                   ...
93
 
            </headers>
94
 
 
95
 
            <libs>
96
 
                /path1/to/library(ies)/
97
 
                /path2/to/library(ies)/
98
 
                   ...
99
 
            </libs>
100
 
 
101
 
   2. abi-compliance-checker -lib NAME -d1 OLD.xml -d2 NEW.xml
102
 
   3. For advanced usage, see doc/Readme.html or --help option
103
 
 
104
 
 
105
 
 
106
 
Enjoy!