| /* |
| * Copyright 2011 Google Inc. |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #ifndef DOMAIN_REGISTRY_DOMAIN_REGISTRY_H_ |
| #define DOMAIN_REGISTRY_DOMAIN_REGISTRY_H_ |
| |
| #include <stdlib.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /* |
| * Call once at program startup to enable domain registry |
| * search. Calls to GetRegistryLength will crash if this is not |
| * called. |
| */ |
| void InitializeDomainRegistry(void); |
| |
| /* |
| * Finds the length in bytes of the registrar portion of the host in |
| * the given hostname. Returns 0 if the hostname is invalid or has no |
| * host (e.g. a file: URL). Returns 0 if the hostname has multiple |
| * trailing dots. If no matching rule is found in the effective-TLD |
| * data, returns 0. Internationalized domain names (IDNs) must be |
| * converted to punycode first. Non-ASCII hostnames or hostnames |
| * longer than 127 bytes will return 0. It is an error to pass in an |
| * IP address (either IPv4 or IPv6) and the return value in this case |
| * is undefined. |
| * |
| * Examples: |
| * www.google.com -> 3 (com) |
| * WWW.gOoGlE.cOm -> 3 (com, case insensitive) |
| * ..google.com -> 3 (com) |
| * google.com. -> 4 (com) |
| * a.b.co.uk -> 5 (co.uk) |
| * a.b.co..uk -> 0 (multiple dots in registry) |
| * C: -> 0 (no host) |
| * google.com.. -> 0 (multiple trailing dots) |
| * bar -> 0 (no subcomponents) |
| * co.uk -> 5 (co.uk) |
| * foo.bar -> 0 (not a valid top-level registry) |
| * foo.臺灣 -> 0 (not converted to punycode) |
| * foo.xn--nnx388a -> 11 (punycode representation of 臺灣) |
| * 192.168.0.1 -> ? (IP address, retval undefined) |
| */ |
| size_t GetRegistryLength(const char* hostname); |
| |
| /* |
| * Like GetRegistryLength, but allows unknown registries as well. If |
| * the hostname is part of a known registry, the return value will be |
| * identical to that of GetRegistryLength. If the hostname is not part |
| * of a known registry (e.g. foo.bar) then the return value will |
| * assume that the rootmost hostname-part is the registry. It is an |
| * error to pass in an IP address (either IPv4 or IPv6) and the return |
| * value in this case is undefined. |
| * |
| * Examples: |
| * foo.bar -> 3 (bar) |
| * bar -> 0 (host is a registry) |
| * www.google.com -> 3 (com) |
| * com -> 0 (host is a registry) |
| * co.uk -> 0 (host is a registry) |
| * foo.臺灣 -> 0 (not converted to punycode) |
| * foo.xn--nnx388a -> 11 (punycode representation of 臺灣) |
| * 192.168.0.1 -> ? (IP address, retval undefined) |
| */ |
| size_t GetRegistryLengthAllowUnknownRegistries(const char* hostname); |
| |
| /* |
| * Override the assertion handler by providing a custom assert handler |
| * implementation. The assertion handler will be invoked when an |
| * internal assertion fails. This is usually indicative of a fatal |
| * error and execution should not be allowed to continue. The default |
| * implementation logs the assertion information to stderr and invokes |
| * abort(). The parameter "file" is the filename where the assertion |
| * was triggered. "line_number" is the line number in that |
| * file. "cond_str" is the string representation of the assertion that |
| * failed. |
| */ |
| typedef void (*DomainRegistryAssertHandler)( |
| const char* file, int line_number, const char* cond_str); |
| void SetDomainRegistryAssertHandler(DomainRegistryAssertHandler handler); |
| |
| #ifdef __cplusplus |
| } /* extern "C" */ |
| #endif |
| |
| #endif /* DOMAIN_REGISTRY_DOMAIN_REGISTRY_H_ */ |
