Installing Seagull on Mac OS X

Sunday, November 22, 2009 em 04:29
Ahh... Nothing like a rainy Saturday to get in the mood for some tasks that were delayed for too long!

As I was getting ready to watch the soccer match between FC Porto (my team) and Oliveirense, at Oliveirense's stadium, the referee decided that there were no conditions (really bad pitch, also due to the rain) for the game to happen... well, I had to do something... :-)

Installing Seagull (the network traffic generator, useful for my Diameter tests) in my iMac was one of those tasks that I could never find the time, and today it seemed a good day. I knew it was not going to be a simple task, as I've tried sometime ago to install (ie, build from source) under Ubuntu or some other Linux distro and never made it... but I didn't tried hard either, as there are RHEL/Fedora binaries I just setup a VM with it.

OK.. So, first step was to look for someone who had already done the job... couldn't find any, seems like Mac's are not chosen as dev machines very often. No binaries, no instructions. I'm on my own.

The INSTALL.TXT has some instructions on how to build it... the commands to run. I'll do it as I like to: run until it crashes and see what's wrong after. First instruction is:
Edit build.conf to fit your needs (default should be OK)

If it says it should be OK, it should be OK. Let's move on.
run "./build.ksh -target clean"

Just to make sure everything is clean. Not a problem, no issues here. Next!
run "./build.ksh -target all"

This is where the "fun" began. It simply failed with some  generic failure message:
[Begin Makefile generation phase]
[Creating symbolic link: /Users/ammendonca/Desktop/seagull/bin]
[Making directory: /Users/ammendonca/Desktop/seagull/work-1.8.1]
[Making directory: /Users/ammendonca/Desktop/seagull/build-1.8.1]
make: *** [/Users/ammendonca/Desktop/seagull/work-1.8.1/project.mk] Error 1
 
[Begin compilation phase]
make: *** No rule to make target `all'.  Stop.

Nice, isn't it? Not much clues of what and where it is failing. After running some pieces of the make script by itself, I got to ./work-1.8.1/compiler.mk file where it said "Compiler variable for OS DARWIN not defined".

For adding this information, it was needed to edit the ./build.conf afterall :-). So I just copied all the (...)_LINUX entries and renamed them to _DARWIN, et voilá. It worked.

Next ran, next failure:
[Compiling protocol-external/C_ProtocolExternal.cpp]
[Compiling protocol-text/C_MessageText.cpp]
cc1plus: warnings being treated as errors
protocol-text/C_MessageText.cpp: In member function 'C_ProtocolFrame::_msg_error_code C_MessageText::EncodeWithContentLength(int)':
protocol-text/C_MessageText.cpp:62: warning: format '%d' expects type 'int', but argument 4 has type 'size_t'
make[1]: *** [/Users/ammendonca/Desktop/seagull/work-1.8.1/C_MessageText.o] Error 1
make: *** [all_seagull] Error 2

This was a pretty simple and obvious one. Just learned how size_t should be printed, it's with %Zd instead of the %d that is present. Made that change at line 62 of ./protocol-text/C_MessageText.cpp and that's it!

One step closer... but not there yet:
[Compiling /Users/ammendonca/Desktop/seagull/work-1.8.1/y.tab.c]
y.tab.c: In function 'int yyparse()':
y.tab.c:1349: error: 'yylex' was not declared in this scope
y.tab.c:1587: error: 'yyerror' was not declared in this scope
y.tab.c:1733: error: 'yyerror' was not declared in this scope
make[1]: *** [/Users/ammendonca/Desktop/seagull/work-1.8.1/y.tab.o] Error 1
make: *** [all_seagull] Error 2

Checking the referred y.tab.c I've checked it declared those methods only if some vars (__linux__ OR __CYGWIN__) were declared. This should be some compiler info as my friend grep didn't found any reference on the seagull sources. Googled a little bit and just found what it was and so I checked it should be __APPLE__ for my system.

A previous message showed that this y.tab.c file was being generated and, so, with the help of grep I managed to find out that it came from ./xml-parser/xml_definition.y, at line 38. Changed
#if defined(__linux__) || defined(__CYGWIN__)
to
#if defined(__linux__) || defined(__CYGWIN__) || defined(__APPLE__)

It was almost there... got the binary seagull already linked in the ./bin folder! Good news, but still some required lib is failing to link:
[Linking /Users/ammendonca/Desktop/seagull/build-1.8.1/libtrans_ip.so]
Undefined symbols:
  "_main", referenced from:
      start in crt1.10.5.o
ld: symbol(s) not found
collect2: ld returned 1 exit status
make[1]: *** [/Users/ammendonca/Desktop/seagull/build-1.8.1/libtrans_ip.so] Error 1
make: *** [all_libtrans_ip.so] Error 2

Boooring! Thought this could be it... so much work and now some weird linkage error was going to throw it all away. Well.. can't give up, tried some own ideas... then went googling, nothing much useful, every linkage error seems to have this same output.

Since it referred main, started looking for it.. no sign of it in the files being linked. Hmm.. that makes sense, it's a library, why would it need to have a main anyway? After checking the flags being used for compilation, just found out this one for compiling a library was not present: -dynamiclib

So I added it to BUILD_LIB_LD_FLAGS_DARWIN in ./build.conf which now looked like this:
BUILD_LIB_LD_FLAGS_DARWIN="-shared -fPIC -dynamiclib"

Yeah! Everything worked just fine! The install was completed successfully and all the binaries were in the bin folder. Hurray!

This was a lengthy journey but in the end it was fruitful.. as always, when it works ;-) Seagull v1.8.1 running on Mac OS X 10.5.6 (Leopard)!

Notes:
  1. Apple Dev Tools are required to be installed prior to any of this being made. They can be found in  the Install DVD;
  2. I had to run the commands with "sudo" as it required permissions for some operations;
  3. Optionally you can run "./install.ksh" to copy Seagull binaries and config files as suggested in INSTALL.TXT and perform the remaining actions, if needed.

Please let me know if this has been useful for you and/or if something is inaccurate. This has been tested against Seagull 1.7.0 and 1.8.1 on Mac OS X 10.5.6 (Leopard).

10 comentários

  1. Unknown Says:

    hi,

    this post has been useful for me on windows 7. In build.conf, I copied the *_CYGWIN_5_1 variables to *_CYGWIN_6_1 and it worked. I had to install mksh (make a symlink to /bin/ksh manually), bison and flex on cygwin and it worked. I did not have those link errors.

    Thanks for sharing.

    yohann

  2. Anonymous Says:

    Your post was a big help. I am trying to install Seagull 1.8.2 on OSX 10.6.8. I ran into the following errors. You must have a different environment such that you have the gnu libraries. I have not had any luck finding the libraries.

    ./octcap_include/OC/oc_config.h:47:47: error: features.h: No such file or directory
    ./octcap_include/OC/oc_config.h:48:20: error: endian.h: No such file or directory
    make[1]: *** [/Users/jmorgan/Downloads/seagull.svn.mac/work-1.8.2/C_TCAPMsgBuildContextANSI.o] Error 1

  3. Anonymous Says:

    @ KayakJamie, you may do like this in the build.conf put some "#" / Hash" comment in this part ... , your intention only need to enjoy diameter right ?

    # HP OC TCAP transport library
    #BUILD_8_NAME="libtrans_octcap.so"
    #BUILD_8_TYPE=tcap_lib
    #BUILD_8_MODULES="common transport-frame protocol-frame library-trans-octcap32"

    # sctp transport library
    #BUILD_9_NAME="libtrans_extsctp.so"
    #BUILD_9_TYPE=libextsctp
    #BUILD_9_MODULES="common transport-frame protocol-frame library-trans-ip library-trans-extsctp"

    # tls transport library
    #BUILD_10_NAME="libtrans_iptls.so"
    #BUILD_10_TYPE=libiptls
    #BUILD_10_MODULES="common protocol-frame transport-frame library-trans-ip library-trans-tls"

    # crypto library
    #BUILD_11_NAME="lib_crypto.so"
    #BUILD_11_TYPE=libcrypto
    #BUILD_11_MODULES="common protocol-frame library-crypto"

  4. Anonymous Says:

    Thanks for your kind information on allowing Seagull to be able to run on our favorite MacOSX.

    I have installed Apple Development Tool, where the Developer directory is available from root directory. However it looks like my basic setup for those necessary library files are not in the path perhaps so I experienced below errors:

    [Generating file seagull]
    make[1]: Entering directory `/users/boyce/Downloads/seagull.svn.LINUX'
    [Compiling common/C_RegExp.cpp]
    In file included from common/C_RegExp.hpp:23,
    from common/C_RegExp.cpp:20:
    common/types_t.hpp:23:18: error: cctype: No such file or directory
    In file included from common/C_RegExp.cpp:20:
    common/C_RegExp.hpp:24:19: error: regex.h: No such file or directory
    In file included from common/C_RegExp.cpp:21:
    common/string_t.hpp:23:18: error: string: No such file or directory
    In file included from common/C_RegExp.cpp:22:
    common/Utils.hpp:30:18: error: cstdio: No such file or directory
    common/Utils.hpp:31:19: error: cstdlib: No such file or directory
    In file included from common/Utils.hpp:33,
    from common/C_RegExp.cpp:22:
    common/iostream_t.hpp:40:20: error: iostream: No such file or directory
    common/iostream_t.hpp:41:19: error: iomanip: No such file or directory

    When I search through my Developer directory, I can locate all necessary files. Please help show me some light about how to correct my basic setup so as to allow compilation to locate those necessary library files.

    My Mac version is 10.6.8 and my Seagull version is latest stable 1.8.2 release at 2010-10-27.

    Boyce

  5. Anonymous Says:

    I uninstalled my existing Xcode and then download the latest xcode_3.2.6_and_ios_sdk_4.3 for my Snow Leopard

    This time the compilation can move forward, but still stuck in below error:

    [Generating y.tab.c]
    [Generating lex.yy.c]
    [Compiling /Users/boyce/Downloads/seagull.svn.LINUX/work-1.8.2/lex.yy.c]
    yacc xml-parser/xml_definition.y
    mv -f y.tab.c xml-parser/xml_definition.c
    cc -c -o xml-parser/xml_definition.o xml-parser/xml_definition.c
    xml-parser/xml_definition.y:21:30: error: GeneratorTrace.hpp: No such file or directory
    In file included from xml-parser/C_XmlParser.hpp:23,
    from xml-parser/xml_definition.y:22:
    xml-parser/C_XmlData.hpp:23:22: error: list_t.hpp: No such file or directory
    xml-parser/C_XmlData.hpp:24:26: error: iostream_t.hpp: No such file or directory
    In file included from xml-parser/C_XmlParser.hpp:23,
    from xml-parser/xml_definition.y:22:
    xml-parser/C_XmlData.hpp:26: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘_C_XmlEntity_Basic’
    xml-parser/C_XmlData.hpp:38: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘C_XmlData’
    xml-parser/C_XmlData.hpp:83: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘*’ token
    xml-parser/C_XmlData.hpp:84: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘<’ token
    In file included from xml-parser/xml_definition.y:22:
    xml-parser/C_XmlParser.hpp:25:24: error: string_t.hpp: No such file or directory
    xml-parser/C_XmlParser.hpp:26:24: error: vector_t.hpp: No such file or directory
    xml-parser/C_XmlParser.hpp:27:18: error: cstdio: No such file or directory
    In file included from xml-parser/xml_definition.y:22:
    xml-parser/C_XmlParser.hpp:29: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘C_XmlParser’
    xml-parser/xml_definition.y:23:21: error: Utils.hpp: No such file or directory
    xml-parser/xml_definition.y:31: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘*’ token
    xml-parser/xml_definition.y:35: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘*’ token
    xml-parser/xml_definition.y: In function ‘yyparse’:
    xml-parser/xml_definition.y:80: error: ‘XmlParserClass’ undeclared (first use in this function)
    xml-parser/xml_definition.y:80: error: (Each undeclared identifier is reported only once
    xml-parser/xml_definition.y:80: error: for each function it appears in.)
    xml-parser/xml_definition.y:87: error: invalid operands to binary << (have ‘char *’ and ‘char *’)
    xml-parser/xml_definition.y:93: error: ‘false’ undeclared (first use in this function)
    xml-parser/xml_definition.y:96: error: invalid operands to binary << (have ‘char *’ and ‘char *’)
    xml-parser/xml_definition.y:108: error: invalid operands to binary << (have ‘char *’ and ‘char *’)
    xml-parser/xml_definition.y:139: error: invalid operands to binary << (have ‘char *’ and ‘char *’)
    xml-parser/xml_definition.y:150: error: invalid operands to binary << (have ‘char *’ and ‘char *’)
    xml-parser/xml_definition.y: At top level:
    xml-parser/xml_definition.y:157: error: expected ‘)’ before ‘*’ token
    xml-parser/xml_definition.y: In function ‘yyerror’:
    xml-parser/xml_definition.y:178: error: ‘E_GEN_FATAL_ERROR’ undeclared (first use in this function)
    xml-parser/xml_definition.y:179: error: ‘XmlParserClass’ undeclared (first use in this function)
    xml-parser/xml_definition.y:182: error: invalid operands to binary << (have ‘char *’ and ‘const char *’)
    make[1]: *** [xml-parser/xml_definition.o] Error 1
    rm xml-parser/xml_definition.c
    make[1]: Leaving directory `/Users/boyce/Downloads/seagull.svn.LINUX'
    make: *** [all_seagull] Error 2

    Any idea about why it would have such error?

    Boyce

  6. Anonymous Says:

    Those files being reported "No such file or directory" can be found from source code.

    How can it be linked so that they can be referred?

    Boyce

  7. Vincent Says:

    Hi,

    Thanks for this post. Did you manage to get it working finally?
    I am interested as I might need to do the same!

    -Vincent

  8. Prem Says:

    Hi,

    Thanks for the post I have managed to compile v1.8.2 on Mac OSX 10.7.5 with Xcode 4.5.2 and xcode command line tools. Few observation openSSL api are depricated so had to include
    #if defined(__APPLE__)
    #define COMMON_DIGEST_FOR_OPENSSL
    #include
    #define SHA1 CC_SHA1
    #else
    #include
    #endif

    Then the typedef have changed so include C_FLAG "-D_DARWIN_C_SOURCE

  9. Unknown Says:

    This is really great information found here, I really like your blog. Thanks very much for the share. Keep posting.


    _____________________________
    Video player for Mac

  10. hemmymission Says:

    Thanks for sharing in detail. Your blog is an inspiration! Apart of really useful tips, it's just really !

    _____________________
    Clipping Magic

Post a Comment