how to use some test programs/samples

asked 2014-05-02 07:56:01 -0700

alphaemmeo gravatar image

updated 2014-05-07 00:41:10 -0700

Hi folks,

is there a documentation that explains the features and how to use the test programs/samples as: advtunnel, autochat, bbclient, bbjoin, bignum, mc-rcv, remarshal, bastress2, etc. in .../core/alljoyn/build/linux/x86_64/debug/dist/cpp/bin ?

Thanks in advance.

edit retag flag offensive close merge delete

1 answer

Sort by ยป oldest newest most voted

answered 2014-05-02 14:58:22 -0700

this post is marked as community wiki

This post is a wiki. Anyone with karma >75 is welcome to improve it.

No there are not documents that explains how to use the programs listed. Most of the programs are test programs and are not intended as samples.

The only programs that really are samples are in the core/alljoyn/build/linux/x86_64/debug/dist/cpp/bin/samples folder. The code used to build those samples can be found in core/alljoyn/build/linux/x86_64/debug/dist/cpp/samples

Since you are giving the full build path I can tell you are building from source not from the SDK. The code used to build all of the test programs is in core/alljoyn/alljoyn_core/test or core/alljoyn/alljoyn_core/router/test. All of the programs were made to test something or while trying to get something working in the development process. Major difference between the samples and the test programs. The samples are limited to the public SDK while the test programs have access to all headers found in the AllJoyn project. Developers can and do write test programs using code that is not publicly available. Some of the test code has been reproduced in the google test unit tests and probably should be removed.

The test programs could be changed or removed at anytime so should not be used outside there original use case.

I don't know what all of the test programs do here is my a list of what they do to the best of my understanding:

I will make this answer a community wiki so anyone can quickly add to this list if they know more

  • advtunnel: program used to forward name service packets between Android emulator and its host OS. The idea was to bypass the Android sandbox environment making it possible to test AllJoyn applications using an Android emulator. It never worked properly but had potential.
  • aes_ccm: tests AES-CCM (Encryption) against the RFC 3610 test vectors
  • autochat: test program that continuously sends out a chat signal at random times. looks like it has not been updated in a long time an may no longer work
  • bastress: test program designed to start and stop BusAttachments using an internal routing node at random intervals. This was a program designed to stress the startup and shut down code.
  • bastress2: similar to bastress but it also runs discovery as well
  • bbclient: basic test program used to test a wide range of use cases used with bbservice well maintained but not intended as a sample.
  • bbjitter: test roundtrip times and computes the jitter
  • bbjoin: another test program designed for testing multipoint sessions.
  • bbservice: basic test program used to test a wide range of use cases used with bbclient
  • bbsig: used to test sending of signals
  • bignum: used to test the big numbers code. The big numbers are used for security. Some security protocols require the ability to use numbers much larger than 32 or 64 bits.
  • compression: code testing header compression
  • keystore: test the keystore and keyblob functionality
  • marshal: tests AllJoyns use of the DBus wire protocol
  • names: test name ...
edit flag offensive delete publish link more
Login/Signup to Answer

Question Tools



Asked: 2014-05-02 07:56:01 -0700

Seen: 206 times

Last updated: May 07 '14