Yeah, it’s due Halloween… so get it done Tuesday ;)

In this lab, you’ll be writing a simple file compression/decompression utility. No, you’re not writing a compression algorithm!! Instead, you’ll dynamically load zlib to do the compression and decompression for you.

This lab is a little more hands-off. I’m giving you a goal and some tools, and I wanna see how well you can put them together into a functioning program.

Refer to the official zlib documentation for the three functions you’ll be using.


Getting started

First get a little test file from me:

$ cp /afs/pitt.edu/home/j/f/jfb42/public/html/img1.bmp .

Then, here’s how your program should work:

$ ./lab6 -c img1.bmp > compressedimg1
$ ./lab6 -d compressedimg1 > img2.bmp

You can use ls -l to see the size of the files in bytes. The original and final image files should be 1179702 bytes. The compressed file should be 995320 bytes.

The first command compresses img1.bmp into the compressedimg1 file. The second decompresses that file into img2.bmp.

After those two commands, img1.bmp and img2.bmp should be identical - in contents and length.


Your program

Here is a description of how your program will work. Remember to start writing your code from the top down. Stub out some functions for doing these things and call them from main.

Your program should be fairly robust. It should give an error message and then exit in the following situations:


How to do dynamic loading on UNIX

#include <dlfcn.h> in your program.

When you compile, give gcc the -ldl (that’s lowercase LDL) flag, like gcc -o lab6 -ldl abc123_lab6.c.

To dynamically load a library:

void* lib = dlopen(library_file_name, RTLD_NOW);

if(lib == NULL)
{
    // couldn't load the library!
    // give an error and exit.
}

Then, to extract symbols from it, use dlsym:

void (*brand_new_function)() = dlsym(lib, "brand_new_function");

if(brand_new_function == NULL)
{
    // couldn't load the symbol!
    // give an error and exit.
}

Be sure to check the return values of dlopen/dlsym as shown above. Otherwise you’ll start getting segfaults and not know why.


Loading zlib and the needed functions

On thoth, zlib is already installed. It’s named "libz.so", so use that as the first argument to dlopen.

You can make these global variables in your program. This is actually a legitimate use for globals!

The three functions you need to extract are the following:

unsigned long (*compressBound)(unsigned long length);
int (*compress)(void *dest, unsigned long* destLen,
		const void* source, unsigned long sourceLen);
int (*uncompress)(void *dest, unsigned long* destLen,
		const void* source, unsigned long sourceLen);

For example, to load compressBound,

compressBound = dlsym(lib, "compressBound");

if(compressBound == NULL)
{
    // uh oh...
}

How big is a file?

If you’ve opened a file, and you want to see how many bytes it is, it’s simple:


Using the zlib compress and uncompress functions

Both functions have the same sort of prototype. Let’s look at compress for now:

int (*compress)(void *dest, unsigned long* destLen, const void* source, unsigned long sourceLen);

uncompress works virtually identically, except swap the words “compressed” and “uncompressed.” :P


Using fread/fwrite with single variables

You can think of a single variable as an array of length 1. So…

unsigned long myvar = ...;
fwrite(&myvar, sizeof(myvar), 1, myfile);

Submission

Make sure you implemented error checking as detailed above!

Then submit as usual.