2.1 Compile under Un*x

IMYplay, in various versions, has been successfully compiled on the following systems:

• Fedora Core 4 GNU/Linux, i686
• Fedora 12 GNU/Linux, i686
• Mandriva 2008.1, 2011 GNU/Linux, i686
• OpenMandriva 3.0, 4.2, 4.3 GNU/Linux, amd64
• OpenBSD 3.8, i586
• Debian 5.0 GNU/Linux, i686
• FreeBSD
• Solaris/SunOS
• macOS

Requirements for compiling the full version of the program under Un*x:

• a working C compiler
• development package for the C library (like glibc-devel and glibc-headers). The getopt.h header and the ‘getopt_long()’ from it are not required, but useful. The signal.h header is used to catch signals, and is optional. The translation headers (locale.h, libintl.h or other) are optional.
• if you want sound, not just MIDI conversion, a development package for one of the supported libraries (except OSS and PC-speaker, which require only the C library and system support). If you don’t have any of these installed or available, then go to
  http://alleg.sf.net/
  http://www.libsdl.org/
  http://alsa-project.org/
  http://xiph.org/ao/
  http://www.portaudio.com/
  http://www.pulseaudio.org/
  http://jackaudio.org/
  http://gstreamer.freedesktop.org/
  
• MIDI output requires the following functions from the standard C library: ‘malloc()’, ‘realloc()’, ‘memset()’, ‘memcpy()’, ‘fopen()’, ‘fwrite()’, ‘fseek()’, ‘fclose()’ and ‘qsort()’.

Type

‘./configure’

to configure the program for your system.

If you do not with support for a particular output mechanism, give the --enable-NAME=no option to ‘./configure’ (NAME=allegro, SDL, SDL2, ALSA, OSS, LIBAO, PORTAUDIO, PULSEAUDIO, JACK, MIDI, EXEC, GSTREAMER, FILE, SPKR).

Run ‘./configure --help’ for details.

By default, a flex-based scanner will be generated to parse the input file, if flex is available. If the scanner does not compile for you or works incorrectly (it hangs on binary files, for example), disable it with

‘./configure --enable-FLEXPARSER=no’

and recompile IMYplay.

If you do NOT wish IMYplay to use the network or get the computer’s IP address, get LibHideIP>=0.2 and LibNetBlock and configure IMYplay with

‘./configure --enable-LIBHIDEIP --enable-LIBNETBLOCK’

NOTE: this may cause network sound output to fail.

Type

‘make’

to compile the program.

Documentation is compiled, but may be recompiled, if you have the makeinfo program (texinfo package). Translations will be compiled, if you have the gettext package.

NOTE: if you have trouble compiling, send me:

1. the compiler name and version (e.g. ‘gcc version 10’),
2. the C standard library name and version (e.g. ‘glibc version 2.x’),
3. the output of the configure script. You can capture it by running ‘./configure > configure-output.txt 2>&1’,
4. the generated config.log file,
5. the generated config.h file, if it exists,
6. the output of the make command. You can capture it by running ‘make > make-output.txt 2>&1’,
7. any other error messages,
8. any other information that you think could lead to solving the problem.

Type

‘make install’

to install the program.

NOTE: ‘make install’ is NOT recommended. Create and install an RPM package instead, if possible.

To create an RPM package:

1. copy the imyplay.spc file to $HOME/rpmbuild/SPECS
2. copy the source package imyplay-2.0.tar.gz to $HOME/rpmbuild/SOURCES
3. type ‘rpmbuild -bb $HOME/rpmbuild/SPECS/imyplay.spc’
4. get the RPMs from $HOME/rpmbuild/RPMS/your_cpu_arch

To create an RPM package (the old way):

1. copy the imyplay.spc file to /usr/src/redhat/SPECS
2. copy the source package imyplay-2.0.tar.gz to /usr/src/redhat/SOURCES
3. type ‘rpmbuild -bb /usr/src/redhat/SPECS/imyplay.spc’
4. get the RPMs from /usr/src/redhat/RPMS/your_cpu_arch

NOTE: some systems may use other directories than these.