NAME

       loc_database_new - Create a new libloc context

SYNOPSIS

       #include <libloc/libloc.h>
       #include <libloc/database.h>

       struct loc_database;

       int loc_database_new(struct loc_ctx* ctx, struct loc_database** database, FILE* f);

       Reference Counting:

       struct loc_database* loc_database_ref(struct loc_database* db);

       struct loc_database* loc_database_unref(struct loc_database* db);

       Access some data:

       time_t loc_database_created_at(struct loc_database* db);

       const char* loc_database_get_vendor(struct loc_database* db);

       const char* loc_database_get_description(struct loc_database* db);

       const char* loc_database_get_license(struct loc_database* db);

DESCRIPTION

       loc_database_new() opens a new database from the given file descriptor. The file descriptor can be closed
       after this operation because the function is creating its own copy.

       If the database could be opened successfully, zero is returned. Otherwise a non-zero return code will
       indicate an error and errno will be set appropriately.

       Various meta-data about the database can be retrieved with loc_database_created_at(),
       loc_database_get_vendor(), loc_database_get_description(), and loc_database_get_license().

SEE ALSO

       libloc(3)

AUTHORS

       Michael Tremer

                                                                                             LOC_DATABASE_NEW(3)