mpg123 - Fast console MPEG Audio Player and decoder library

I feel the need remind the world about the messy issue of large file support (sometimes called largefile support instead;-). There are certain systems (notably GNU/Linux and Solaris) that have chosen to make that a decision at build time with the type off_t sometimes being 32bit, sometimes 64bit. You can compile apps with or without large file support.

That means that you can have libraries for 64bit file offsets on your system and libraries for 32bit offsets. You can have applications (trying to) using libraries with a different file offset setting. That means one thing: Trouble! To prevent weird runtime errors or even crashes, I added some precautions to libmpg123, notably at build time, you could see such a message:

/usr/include/mpg123.h:37:2: error: #error "Mismatch in large file setup!

Also, at runtime, a 64bit offset libmpg123 will fail with a program that is not aware of this -- yielding unresolved symbols due to renaming the affected functions with a suffix indicating 64bits.

If you encounter this, please read up and think about that problem, and possibly complain to your OS distribution or the software project whose code is failing. Especially GNU/Linux distributions should be interested in making sure that they don't mix largefile builds with non-largefile code.

Update: See the FAQ.