SysTutorials

Linux Manual Pages › Section 3

metalink_parse_fp(3)

NAME

metalink_parse_file, metalink_parse_fp, metalink_parse_fd, metalink_parse_memory – Parse Metalink file and create metalink_t object.

SYNOPSIS

#include <metalink/metalink_parser.h>

metalink_error_t metalink_parse_file(const char *filename, metalink_t **res);
metalink_error_t metalink_parse_fp(FILE *docfp, metalink_t **res);
metalink_error_t metalink_parse_fd(int docfd, metalink_t **res);
metalink_error_t metalink_parse_memory(const char *buf, size_t len, metalink_t **res);

DESCRIPTION

These functions parse Metalink file data and constructs metalink_t structure. You don’t have to allocate memory for metalink_t structure. They take the pointer of metalink_t pointer and allocate memory for that pointer.

metalink_parse_file() parses Metalink file denoted by filename and constructs metalink_t structure.

metalink_parse_fp() reads data from file stream docfp and construtcts metalink_t structure.

metalink_parse_fd() reads data from file descriptor docfd and constructs metalink_t structure.

metalink_parse_memory() parses len bytes of buf and constructs metalink_t structure.

The caller must free the memory allocated for metalink_t structure using metalink_delete(3) if it is no longer used.

RETURN VALUE

All functions return 0 for success. When error occurred, non-zero value error code is returned and metalink_t structure is not allocated. The error codes are described in metalink_error.h.

EXAMPLE


#include <metalink/metalink_parser.h>
#include <stdio.h>
#include <stdlib.h>
int main(int argc, char **argv)
{
    metalink_error_t r;
    metalink_t *metalink;
    metalink_file_t *file;
    metalink_checksum_t **checksums;
    r = metalink_parse_file("sample.metalink", &metalink);
    if (r != 0) {
        fprintf(stderr, "ERROR: code=%d
", r);
        exit(EXIT_FAILURE);
    }
    file = metalink->files[0];
    printf("name: %s
", file->name);
    printf("size: %lld
", file->size);
    printf("os  : %s
", file->os);
    if (file->checksums) {
        checksums = file->checksums;
        while (*checksums) {
            printf("hash: %s %s
", (*checksums)->type, (*checksums)->hash);
            ++checksums;
        }
    }
    if (file->chunk_checksum) {
        size_t count = 0;
        metalink_piece_hash_t **piece_hashes;
        printf("chunk checksum: size=%d, type=%s
",
               file->chunk_checksum->length,
               file->chunk_checksum->type);
        printf("first 5 piece hashes...
");
        piece_hashes = file->chunk_checksum->piece_hashes;
        while (*piece_hashes && count < 5) {
            printf("piece=%d, hash=%s
", (*piece_hashes)->piece,
                   (*piece_hashes)->hash);
            ++piece_hashes;
            ++count;
        }
        printf("...
");
    }
    if (file->resources) {
        size_t count = 0;
        metalink_resource_t **resources;
        printf("first 5 resources...
");
        resources = file->resources;
        while (*resources && count < 5) {
            printf("type=%s, location=%s, preference=%d, url=%s
",
                   (*resources)->type, (*resources)->location,
                   (*resources)->preference, (*resources)->url);
            ++resources;
            ++count;
        }
        printf("...
");
    }
    /* delete metalink_t */
    metalink_delete(metalink);
    return EXIT_SUCCESS;
}

SEE ALSO

metalink_delete(3), metalink_parse_update(3), metalink_t(3)