diff --git a/api-index-full.html b/api-index-full.html index a019699..6cb21d3 100644 --- a/api-index-full.html +++ b/api-index-full.html @@ -17,6 +17,8 @@  |  C  |  + D +  |  E  |  F @@ -74,6 +76,11 @@ psl_ctx_t, typedef in Public Suffix List functions
+

D

+
+psl_dist_filename, function in Public Suffix List functions +
+

E

psl_error_t, enum in Public Suffix List functions @@ -104,6 +111,10 @@

L

+psl_latest, function in Public Suffix List functions +
+
+
psl_load_file, function in Public Suffix List functions
diff --git a/home.png b/home.png index 884ce1d..c989d46 100644 Binary files a/home.png and b/home.png differ diff --git a/index.html b/index.html index 63de24b..b2971e1 100644 --- a/index.html +++ b/index.html @@ -15,7 +15,7 @@

- for Libpsl 0.15.0 + for Libpsl 0.17.0 . The latest version of this documentation can be found on-line at GitHub. diff --git a/left-insensitive.png b/left-insensitive.png index 148fbff..b1148fb 100644 Binary files a/left-insensitive.png and b/left-insensitive.png differ diff --git a/left.png b/left.png index efdeee7..c164913 100644 Binary files a/left.png and b/left.png differ diff --git a/libpsl-Public-Suffix-List-functions.html b/libpsl-Public-Suffix-List-functions.html index d0f6104..5e3810f 100644 --- a/libpsl-Public-Suffix-List-functions.html +++ b/libpsl-Public-Suffix-List-functions.html @@ -60,6 +60,14 @@ + +psl_ctx_t * + + +psl_latest () + + + const psl_ctx_t * @@ -170,6 +178,13 @@ const char * +psl_dist_filename () + + + +const char * + + psl_get_version () @@ -261,7 +276,7 @@ psl_load_file (const char

This function loads the public suffixes file named fname . To free the allocated resources, call psl_free().

-

The suffixes are expected to be UTF-8 encoded (lowercase + NFCK) if they are international.

+

The suffixes are expected to be UTF-8 encoded (lowercase + NFKC) if they are international.

Parameters

@@ -290,7 +305,7 @@ To free the allocated resources, call FILE *fp);

This function loads the public suffixes from a FILE pointer. To free the allocated resources, call psl_free().

-

The suffixes are expected to be UTF-8 encoded (lowercase + NFCK) if they are international.

+

The suffixes are expected to be UTF-8 encoded (lowercase + NFKC) if they are international.

Parameters

@@ -314,6 +329,42 @@ To free the allocated resources, call +

psl_latest ()

+
psl_ctx_t *
+psl_latest (const char *fname);
+

This function loads the the latest available PSL data from either

+
    +

  • fname + (application specific filename, may be NULL)

    • +

  • location specified during built-time (filename from ./configure --with-psl-distfile)

    • +

  • built-in PSL data (generated from ./configure --with-psl-file)

    • +

  • location of built-in data (filename from ./configure --with-psl-file)

    • +
+

If none of the above is available, the function returns NULL.

+

To free the allocated resources, call psl_free().

+
+

Parameters

+
+++++ + + + + + +

fname

Name of PSL file or NULL

 
+
+
+

Returns

+

Pointer to a PSL context or NULL on failure.

+
+

Since: 0.16

+
+
+

psl_builtin ()

const psl_ctx_t *
 psl_builtin (void);
@@ -321,7 +372,7 @@ psl_builtin (void

The builtin data also contains punycode entries, one for each international domain name.

If the generation of built-in data has been disabled during compilation, NULL will be returned. -When using the builtin psl context, you can provide UTF-8 (lowercase + NFCK) or ASCII/ACE (punycode) +When using the builtin psl context, you can provide UTF-8 (lowercase + NFKC) or ASCII/ACE (punycode) representations of domains to functions like psl_is_public_suffix().

Returns

@@ -364,7 +415,7 @@ psl_is_public_suffix (const Mozilla Public Suffix List.

For cookie domain checking see psl_is_cookie_domain_acceptable().

International domain - names have to be either in UTF-8 (lowercase + NFCK) or in ASCII/ACE format (punycode). + names have to be either in UTF-8 (lowercase + NFKC) or in ASCII/ACE format (punycode). Other encodings likely result in incorrect return values. Use helper function psl_str_to_utf8lower() for normalization domain .

@@ -413,7 +464,7 @@ psl_is_public_suffix2 (const PSL_TYPE_PRIVATE, PSL_TYPE_ICANN and PSL_TYPE_ANY.

International domain - names have to be either in UTF-8 (lowercase + NFCK) or in ASCII/ACE format (punycode). + names have to be either in UTF-8 (lowercase + NFKC) or in ASCII/ACE format (punycode). Other encodings likely result in incorrect return values. Use helper function psl_str_to_utf8lower() for normalization domain .

@@ -463,7 +514,7 @@ psl_unregistrable_domain (const Mozilla Public Suffix List.

International domain - names have to be either in UTF-8 (lowercase + NFCK) or in ASCII/ACE format (punycode). + names have to be either in UTF-8 (lowercase + NFKC) or in ASCII/ACE format (punycode). Other encodings likely result in incorrect return values. Use helper function psl_str_to_utf8lower() for normalization domain .

@@ -511,7 +562,7 @@ psl_registrable_domain (const Mozilla Public Suffix List.

International domain - names have to be either in UTF-8 (lowercase + NFCK) or in ASCII/ACE format (punycode). + names have to be either in UTF-8 (lowercase + NFKC) or in ASCII/ACE format (punycode). Other encodings likely result in incorrect return values. Use helper function psl_str_to_utf8lower() for normalization domain .

@@ -639,7 +690,7 @@ psl_suffix_wildcard_count (const

psl_builtin_file_time ()

time_t
 psl_builtin_file_time (void);
-

This function returns the mtime of the Publix Suffix List file that has been built in.

+

This function returns the mtime of the Public Suffix List file that has been built in.

If the generation of built-in data has been disabled during compilation, 0 will be returned.

Returns

@@ -652,7 +703,7 @@ psl_builtin_file_time (void

psl_builtin_sha1sum ()

const char *
 psl_builtin_sha1sum (void);
-

This function returns the SHA1 checksum of the Publix Suffix List file that has been built in. +

This function returns the SHA1 checksum of the Public Suffix List file that has been built in. The returned string is in lowercase hex encoding, e.g. "2af1e9e3044eda0678bb05949d7cca2f769901d8".

If the generation of built-in data has been disabled during compilation, an empty string will be returned.

@@ -666,7 +717,7 @@ The returned string is in lowercase hex encoding, e.g. "2af1e9e3044eda0678bb0594

psl_builtin_filename ()

const char *
 psl_builtin_filename (void);
-

This function returns the file name of the Publix Suffix List file that has been built in.

+

This function returns the file name of the Public Suffix List file that has been built in.

If the generation of built-in data has been disabled during compilation, an empty string will be returned.

Returns

@@ -702,7 +753,7 @@ psl_is_cookie_domain_acceptable (const hostname and cookie_domain -, have to be either in UTF-8 (lowercase + NFCK) +, have to be either in UTF-8 (lowercase + NFKC) or in ASCII/ACE (punycode) format. Other encodings or mixing UTF-8 and punycode likely result in incorrect return values.

Use helper function psl_str_to_utf8lower() for normalization of hostname and cookie_domain @@ -749,6 +800,20 @@ but NOT for 'forgot.his.name' since 'forgot.his.name' is a public suffix.

+

psl_dist_filename ()

+
const char *
+psl_dist_filename (void);
+

This function returns the file name of the distribution/system PSL data file. +This file will be considered by psl_latest().

+

Return the filename that is set by ./configure --with-psl-distfile, or an empty string.

+
+

Returns

+

String containing a PSL file name or an empty string.

+
+

Since: 0.16

+
+
+

psl_get_version ()

const char *
 psl_get_version (void);
@@ -797,8 +862,8 @@ psl_str_to_utf8lower (const char< const char *encoding, const char *locale, char **lower); -

This helper function converts a string to UTF-8 lowercase + NFCK representation. -Lowercase + NFCK UTF-8 is needed as input to the domain checking functions.

+

This helper function converts a string to UTF-8 lowercase + NFKC representation. +Lowercase + NFKC UTF-8 is needed as input to the domain checking functions.

lower is set to NULL on error.

The return value 'lower' must be freed after usage.

@@ -856,7 +921,7 @@ PSL_ERR_NO_MEM: Failed to allocate memory

Types and Values

PSL_VERSION

-
#define PSL_VERSION "0.15.0"
+
#define PSL_VERSION "0.17.0"
@@ -868,13 +933,13 @@ PSL_ERR_NO_MEM: Failed to allocate memory

PSL_VERSION_MINOR

-
#define PSL_VERSION_MINOR 15
+
#define PSL_VERSION_MINOR 17

PSL_VERSION_NUMBER

-
#define PSL_VERSION_NUMBER 0x000f00
+
#define PSL_VERSION_NUMBER 0x001100
diff --git a/libpsl.devhelp2 b/libpsl.devhelp2 index e61a26c..da17e49 100644 --- a/libpsl.devhelp2 +++ b/libpsl.devhelp2 @@ -11,6 +11,7 @@ + @@ -25,6 +26,7 @@ + diff --git a/right-insensitive.png b/right-insensitive.png index ba481f5..c1efa27 100644 Binary files a/right-insensitive.png and b/right-insensitive.png differ diff --git a/right.png b/right.png index 2e537ba..83361a6 100644 Binary files a/right.png and b/right.png differ diff --git a/up-insensitive.png b/up-insensitive.png index 9317461..13e1a4f 100644 Binary files a/up-insensitive.png and b/up-insensitive.png differ diff --git a/up.png b/up.png index 5ecf9ab..67a9054 100644 Binary files a/up.png and b/up.png differ