Module locus

Data Types

database_edition()

database_edition() = maxmind_database_edition()

database_entry()

database_entry() = locus_mmdb:lookup_success()

database_error()

database_error() = database_unknown | database_not_loaded

database_info()

database_info() = #{metadata := database_metadata(), source := database_source(), version := database_version()}

database_metadata()

database_metadata() = locus_mmdb:metadata()

database_source()

database_source() = locus_loader:source()

database_url()

database_url() = unicode:chardata()

database_version()

database_version() = calendar:datetime()

ip_address_prefix()

ip_address_prefix() = locus_mmdb:ip_address_prefix()

legacy_maxmind_database_edition()

legacy_maxmind_database_edition() = atom()

maxmind_database_edition()

maxmind_database_edition() = {maxmind, atom() | unicode:chardata()} | legacy_maxmind_database_edition()

Function Index

analyze/1Analyzes a loaded database for corruption or incompatibility.
await_loader/1Like await_loader/1 but with a default timeout of 30 seconds.
await_loader/2Blocks caller execution until either readiness is achieved or the default timeout is triggered.
await_loaders/2Like await_loader/2 but it can concurrently await status from more than one database.
get_info/1Returns the properties of a currently loaded database.
get_info/2Returns a specific property of a currently loaded database.
get_version/1(Deprecated.) Returns the currently loaded database version.
loader_child_spec/2Like :loader_child_spec/2 but with default options.
loader_child_spec/3Like :loader_child_spec/3 but with default child id.
loader_child_spec/4Returns a supervisor child spec for a database loader under id DatabaseId with options Opts.
lookup/2Looks-up info on IPv4 and IPv6 addresses.
start_loader/2Like :start_loader/3 but with default options.
start_loader/3Starts a database loader under id DatabaseId with options Opts.
stop_loader/1Stops the database loader under id DatabaseId.
wait_for_loader/1(Deprecated.) Blocks caller execution until either readiness is achieved or a database load attempt fails.
wait_for_loader/2(Deprecated.) Like wait_for_loader/1 but it can time-out.
wait_for_loaders/2(Deprecated.) Like wait_for_loader/2 but it can concurrently await status from more than one database.

Function Details

analyze/1

analyze(DatabaseId) -> ok | {error, Error}

Analyzes a loaded database for corruption or incompatibility.

Returns:

await_loader/1

await_loader(DatabaseId) -> {ok, LoadedVersion} | {error, Reason}

Like await_loader/1 but with a default timeout of 30 seconds.

Returns:

See also: await_loader/2.

await_loader/2

await_loader(DatabaseId, Timeout) -> {ok, LoadedVersion} | {error, Reason}

Blocks caller execution until either readiness is achieved or the default timeout is triggered.

Returns:

See also: await_loader/1, await_loaders/2.

await_loaders/2

await_loaders(DatabaseIds, Timeout) -> {ok, Successes} | {error, {ErrorPerDatabase, PartialSuccesses}}

Like await_loader/2 but it can concurrently await status from more than one database.

Returns:

See also: await_loader/2.

get_info/1

get_info(DatabaseId) -> {ok, Info} | {error, Error}

Returns the properties of a currently loaded database.

Returns:

See also: get_info/2.

get_info/2

get_info(DatabaseId, Property) -> {ok, Value} | {error, Error}

Returns a specific property of a currently loaded database.

Returns:

See also: get_info/1.

get_version/1

get_version(DatabaseId) -> {ok, LoadedVersion} | {error, Error}

This function is deprecated:

Please use get_info/2 instead.

Returns:

Returns the currently loaded database version.

loader_child_spec/2

loader_child_spec(DatabaseId, DatabaseEditionOrURL::DatabaseEdition | DatabaseURL) -> ChildSpec | no_return()

Like :loader_child_spec/2 but with default options

Returns:

See also: await_loader/1, await_loader/2, loader_child_spec/1, loader_child_spec/3, start_loader/2.

loader_child_spec/3

loader_child_spec(DatabaseId, DatabaseEditionOrURL::DatabaseEdition | DatabaseURL, Opts) -> ChildSpec | no_return()

Like :loader_child_spec/3 but with default child id

Returns:

See also: await_loader/1, await_loader/2, loader_child_spec/3, loader_child_spec/4, start_loader/3.

loader_child_spec/4

loader_child_spec(ChildId, DatabaseId, DatabaseEdition::DatabaseEdition | DatabaseURL, Opts) -> ChildSpec | no_return()

Returns a supervisor child spec for a database loader under id DatabaseId with options Opts.

Returns:

See also: await_loader/1, await_loader/2, loader_child_spec/3, start_loader/3.

lookup/2

lookup(DatabaseId, Address) -> {ok, Entry} | {error, Error}

Looks-up info on IPv4 and IPv6 addresses.

Returns:

start_loader/2

start_loader(DatabaseId, DatabaseEditionOrURL::DatabaseEdition | DatabaseURL) -> ok | {error, Error}

Like :start_loader/3 but with default options

Returns:

See also: await_loader/1, await_loader/2, start_loader/1, start_loader/3.

start_loader/3

start_loader(DatabaseId, DatabaseEdition::DatabaseEdition | DatabaseURL, Opts) -> ok | {error, Error}

Starts a database loader under id DatabaseId with options Opts.

Returns:

See also: await_loader/1, await_loader/2, start_loader/1, start_loader/2.

stop_loader/1

stop_loader(DatabaseId) -> ok | {error, Error}

Stops the database loader under id DatabaseId.

Returns ok in case of success, {error, not_found} otherwise.

wait_for_loader/1

wait_for_loader(DatabaseId) -> {ok, LoadedVersion} | {error, Error}

This function is deprecated:

Use await_loader/1 instead.

Returns:

Blocks caller execution until either readiness is achieved or a database load attempt fails.

wait_for_loader/2

wait_for_loader(DatabaseId, Timeout) -> {ok, LoadedVersion} | {error, Reason}

This function is deprecated:

Use await_loader/2 instead.

Returns:

Like wait_for_loader/1 but it can time-out.

wait_for_loaders/2

wait_for_loaders(DatabaseIds, Timeout) -> {ok, LoadedVersionPerDatabase} | {error, Reason}

This function is deprecated:

Use await_loaders/2 instead.

Returns:

Like wait_for_loader/2 but it can concurrently await status from more than one database.


Generated by EDoc