Mercurial > hg > freeDiameter

annotate contrib/README @ 1257:55d0867dd8b8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added a basic Gx implementation in contrib (untested) -- reported working but may need some adaptation
author Sebastien Decugis <sdecugis@freediameter.net>
date Sun, 11 May 2014 22:34:48 +0800
parents 7fd5aed93640
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
327
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
1 This file describes the content of the "contrib" directory.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
2 For information about the freeDiameter project, please refer
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
3 to top-level README file.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
4
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
5 - update_copyright.sh : This script will simply update the copyright information
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
6 in all source files in the freeDiameter mercurial repository, based
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
7 on the last modification time. Thought I might share it if other people find
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
8 it useful for their own project...
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
9
328
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
10
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
11 - debian : This directory contains the packaging information to create native Debian / Ubuntu
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
12 packages. It requires debhelper >= 7.3.9 (support for cmake). To use, simply link the
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
13 debian folder from the main freeDiameter folder, then use your building script as
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
14 usual ('dh binary' or 'pdebuild' or ...).
474
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
15 If you simply intend to use freeDiameter package, the relevant information is located
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
16 at: http://www.freediameter.net/trac/wiki/DebRepository
328
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
17
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
18
327
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
19 - PKI : This directory contains useful material related to establishing a
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
20 Public Key Infrastructure (PKI) for deploying x509 certificates
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
21 and use these for TLS authentication of the freeDiameter nodes.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
22
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
23 IMPORTANT: Please note that these solutions are NOT suitable
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
24 for use in a production environment! It allows easy deployment of
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
25 certificates for tests, and that is their sole purpose.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
26
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
27 The directory contains:
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
28
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
29 - ca_script: a simple Makefile allowing you to generate a self-signed certificate (root)
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
30 and then issue new certificates and private keys for your users.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
31 Run "make" without argument to get the help.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
32
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
33 - ca_script2: An evolution of the previous Makefile. This one allows you
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
34 to create a hierarchy of CA and certificates.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
35
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
36 - phpki-0.82.patch : This patch is to be applied to PHPki to customize the use for freeDiameter.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
37 PHPki (http://sourceforge.net/projects/phpki/) is a PHP-based web interface
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
38 that provides more or less the same services as ca_script.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
39
328
90294e7e986c Moved the debian dir outside the top level directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 327
diff changeset
40
327
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
41 - OpenWRT : This directory contains the scripts and documentation related to
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
42 the integration of freeDiameter RADIUS/Diameter gateway component in the openWRT
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
43 distribution (http://openwrt.org) -- the goal is to give the access point the
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
44 ability to "talk" Diameter instead of RADIUS.
0f43f42669be Reorganized the contrib/ directory
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
45
474
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
46
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
47 - nightly_tests : This directory contains the scripts and documentation for the nightly
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
48 tests run on freeDiameter. The results are published at the following URL:
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
49 http://www.freediameter.net/CDash/index.php?project=freeDiameter
e8c1ff19705e Updated information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 328
diff changeset
50
600
e9c0bdedf2eb Initial draft version of dict_legacy_xml, parses XML file but no conversion to fD yet.
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 474
diff changeset
51
e9c0bdedf2eb Initial draft version of dict_legacy_xml, parses XML file but no conversion to fD yet.
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 474
diff changeset
52 - dict_legacy: XML and DTD files for the dict_legacy_xml.fdx extension.
726
c0c0a7781b09 Added new contribution: Wireshark patch to display Diameter over TLS over SCTP
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 600
diff changeset
53
800
35f3fe884dc9 Updates sent by Konstantin to the dict_dcca files
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 726
diff changeset
54 - dict_dcca: partial implementations of the DCCA dictionary
35f3fe884dc9 Updates sent by Konstantin to the dict_dcca files
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 726
diff changeset
55
830
7fd5aed93640 Included contribution from German Barros
Sebastien Decugis <sdecugis@freediameter.net>
parents: 800
diff changeset
56 - dict_gx: untested implementation of the Gx interface.
7fd5aed93640 Included contribution from German Barros
Sebastien Decugis <sdecugis@freediameter.net>
parents: 800
diff changeset
57
1257
55d0867dd8b8 Added a basic Gx implementation in contrib (untested) -- reported working but may need some adaptation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 830
diff changeset
58 - test_Gx: a responder on the Gx interface that always send SUCCESS status.
55d0867dd8b8 Added a basic Gx implementation in contrib (untested) -- reported working but may need some adaptation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 830
diff changeset
59
726
c0c0a7781b09 Added new contribution: Wireshark patch to display Diameter over TLS over SCTP
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 600
diff changeset
60 - wireshark: This contains some information on how to use Wireshark to monitor Diameter
c0c0a7781b09 Added new contribution: Wireshark patch to display Diameter over TLS over SCTP
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 600
diff changeset
61 exchange protected with TLS. It involves patching the wireshark software.
"Welcome to our mercurial repository"