ar.h File Reference

#include <rz_util.h>

Go to the source code of this file.

Classes
struct	RZARFP

Typedefs
typedef struct RZARFP	RzArFp

Functions
RZ_API RzArFp *	ar_open_file (const char *arname, int perm, const char *filename)
	Open specific file withen a ar/lib file. More...
RZ_API RzList *	ar_open_all (const char *arname, int perm)
	Open specific file withen a ar/lib file. More...
RZ_API void	ar_close (RzArFp *f)
RZ_API int	ar_read_at (RzArFp *f, ut64 off, void *buf, int count)
RZ_API int	ar_write_at (RzArFp *f, ut64 off, void *buf, int count)

Typedef Documentation

RzArFp

typedef struct RZARFP RzArFp

Function Documentation

ar_close()

RZ_API void ar_close

(

RzArFp *

f

)

Definition at line 338 of file ar.c.

                                {
    if (!f) {
        return;
    }
    free(f->name);
    if (!f->shared_buf) {
        rz_buf_free(f->buf);
    }
    free(f);
}

References f, free(), and rz_buf_free().

Referenced by ar_open_all(), ar_open_file(), and rz_io_ar_close().

ar_open_all()

RZ_API RzList* ar_open_all	(	const char *	arname,
		int	perm
	)

Open specific file withen a ar/lib file.

Parameters

arname

the name of the .a file

Returns

a list of files or NULL

Open an ar/lib and returns all the object files inside it.

Definition at line 218 of file ar.c.

                                                         {
    if (!arname) {
        rz_sys_perror(__FUNCTION__);
        return NULL;
    }
 
    RzList *files = rz_list_newf((RzListFree)ar_close);
    if (!files) {
        rz_sys_perror(__FUNCTION__);
        return NULL;
    }
 
    RzBuffer *b = rz_buf_new_file(arname, perm, 0);
    if (!b) {
        rz_list_free(files);
        rz_sys_perror(__FUNCTION__);
        return NULL;
    }
 
    ut64 arsize = rz_buf_size(b);
 
    if (!ar_check_magic(b)) {
        rz_list_free(files);
        rz_buf_free(b);
        return NULL;
    }
 
    filetable tbl = { NULL, 0, 0 };
    int res = -1;
    bool shared = false;
 
    do {
        shared = !rz_list_empty(files);
        RzArFp *arf = arfp_new(b, shared);
        if (!arf) {
            rz_list_free(files);
            if (!shared) {
                rz_buf_free(b);
            }
            return NULL;
        }
        if ((res = ar_parse_header(arf, &tbl, arsize)) <= 0) {
            // on error or when it has reached the EOF
            free(tbl.data);
            ar_close(arf);
            return files;
        }
        if (!rz_list_append(files, arf)) {
            free(tbl.data);
            ar_close(arf);
            rz_list_free(files);
            return NULL;
        }
    } while (res > 0);
 
    // this portion should never be reached
    free(tbl.data);
    return files;
}

References ar_check_magic(), ar_close(), ar_parse_header(), arfp_new(), b, Filetable::data, files, free(), NULL, rz_buf_free(), rz_buf_new_file(), rz_buf_size(), rz_list_append(), rz_list_free(), rz_list_newf(), rz_sys_perror, and ut64().

Referenced by rz_io_ar_open_many().

ar_open_file()

RZ_API RzArFp* ar_open_file	(	const char *	arname,
		int	perm,
		const char *	filename
	)

Open specific file withen a ar/lib file.

Parameters

arname	the name of the .a file
filename	the name of file in the .a file that you wish to open

Returns

a handle of the internal filename or NULL

Open an ar/lib file by name.

Definition at line 286 of file ar.c.

                                                                                {
    if (!filename || !arname) {
        rz_sys_perror(__FUNCTION__);
        return NULL;
    }
 
    RzBuffer *b = rz_buf_new_file(arname, perm, 0);
    if (!b) {
        rz_sys_perror(__FUNCTION__);
        return NULL;
    }
 
    ut64 arsize = rz_buf_size(b);
 
    if (!ar_check_magic(b)) {
        rz_buf_free(b);
        return NULL;
    }
 
    RzArFp *arf = arfp_new(b, NULL);
    if (!arf) {
        rz_buf_free(b);
        return NULL;
    }
 
    filetable tbl = { NULL, 0, 0 };
    int r;
    while ((r = ar_parse_header(arf, &tbl, arsize)) > 0) {
        if (filename) {
            if (!strcmp(filename, arf->name)) {
                // found the right file
                break;
            }
        }
 
        // clean RzArFp for next loop
        arf_clean_name(arf);
    }
 
    free(tbl.data);
 
    if (r <= 0) {
        if (r == 0 && filename) {
            RZ_LOG_ERROR("ar: Cound not find file '%s' in archive '%s'\n", filename, arname);
        }
        ar_close(arf); // results in buf being free'd
        return NULL;
    }
 
    return arf;
}

References ar_check_magic(), ar_close(), ar_parse_header(), arf_clean_name(), arfp_new(), b, Filetable::data, free(), RZARFP::name, NULL, r, rz_buf_free(), rz_buf_new_file(), rz_buf_size(), RZ_LOG_ERROR, rz_sys_perror, and ut64().

Referenced by rz_io_ar_open().

ar_read_at()

RZ_API int ar_read_at	(	RzArFp *	f,
		ut64	off,
		void *	buf,
		int	count
	)

Definition at line 349 of file ar.c.

                                                                 {
    off += f->start;
    if (off > f->end) {
        return -1;
    }
    if (count + off > f->end) {
        count = f->end - off;
    }
    return rz_buf_read_at(f->buf, off, buf, count);
}

References count, f, off, and rz_buf_read_at().

Referenced by rz_io_ar_read().

ar_write_at()

RZ_API int ar_write_at	(	RzArFp *	f,
		ut64	off,
		void *	buf,
		int	count
	)

Definition at line 360 of file ar.c.

                                                                  {
    off += f->start;
    if (off > f->end) {
        return -1;
    }
    if (count + off > f->end) {
        count = f->end - off;
    }
    return rz_buf_write_at(f->buf, off + f->start, buf, count);
}

References count, f, off, and rz_buf_write_at().

Referenced by rz_io_ar_write().