Module Ipaddr

A library for manipulation of IP address representations.

v5.6.0 - homepage

exception Parse_error of string * string

Parse_error (err,packet) is raised when parsing of the IP address syntax fails. err contains a human-readable error and packet is the original octet list that failed to parse.

type scope =
  1. | Point
  2. | Interface
  3. | Admin
  4. | Site
  5. | Organization
  6. | Global

Type of ordered address scope classifications

val string_of_scope : scope -> string

string_of_scope scope returns a human-readable representation of scope.

val scope_of_string : string -> (scope, [> `Msg of string ]) Stdlib.result

scope_of_string s returns a scope from a string representation of s. Valid string values for s can be obtained via string_of_scope.

val pp_scope : Stdlib.Format.formatter -> scope -> unit

pp_scope fmt scope outputs a human-readable representation of scope to the fmt formatter.

module V4 : sig ... end

A collection of functions for IPv4 addresses.

module V6 : sig ... end

A collection of functions for IPv6 addresses.

type ('v4, 'v6) v4v6 =
  1. | V4 of 'v4
  2. | V6 of 'v6

Type of either an IPv4 value or an IPv6 value

type t = (V4.t, V6.t) v4v6

Type of any IP address

val to_string : t -> string

to_string addr is the text string representation of addr.

val to_buffer : Stdlib.Buffer.t -> t -> unit

to_buffer buf addr writes the text string representation of addr into buf.

val pp : Stdlib.Format.formatter -> t -> unit

pp f ip outputs a human-readable representation of ip to the formatter f.

val of_string_exn : string -> t

of_string_exn s parses s as an IPv4 or IPv6 address. Raises Parse_error if s is not a valid string representation of an IP address.

val of_string : string -> (t, [> `Msg of string ]) Stdlib.result

Same as of_string_exn but returns a result type instead of raising an exception.

val of_string_raw : string -> int Stdlib.ref -> t

Same as of_string_exn but takes as an extra argument the offset into the string for reading.

val with_port_of_string : default:int -> string -> (t * int, [> `Msg of string ]) Stdlib.result

with_port_of_string ~default s parses s as an IPv4 or IPv6 address with a possible port seperated by a ':' (if not, we use default). For IPv6, due to the ':' separator, only a full expansion of the IPv6 plus the port lets us to interpret the last :<int> as the port. In other words:

  • ::1:8080 returns the IPv6 ::1:8080 with the default port
  • 0:0:0:0:0:0:0:1:8080 returns ::1 with the port 8080.
val of_octets_exn : string -> t

of_octets_exn octets is the address t represented by octets. The octets must be 4 bytes long for a V4 or 16 if a V6. Raises Parse_error if octets is not a valid representation of an address.

val of_octets : string -> (t, [> `Msg of string ]) Stdlib.result

Same as of_octets_exn but returns a result type instead of raising an exception.

val to_octets : t -> string

to_octets addr returns the bytes representing the addr octets, which will be 4 bytes long if addr is a V4 or 16 if a V6.

val v4_of_v6 : V6.t -> V4.t option

v4_of_v6 ipv6 is the IPv4 representation of the IPv6 address ipv6. If ipv6 is not an IPv4-mapped address, None is returned.

val to_v4 : t -> V4.t option

to_v4 addr is the IPv4 representation of addr.

val v6_of_v4 : V4.t -> V6.t

v6_of_v4 ipv4 is the IPv6 representation of the IPv4 address ipv4.

val to_v6 : t -> V6.t

to_v6 addr is the IPv6 representation of addr.

val scope : t -> scope

scope addr is the classification of addr by the scope hierarchy.

val is_global : t -> bool

is_global addr is a predicate indicating whether addr globally addresses a node.

val is_multicast : t -> bool

is_multicast addr is a predicate indicating whether addr is a multicast address.

val is_private : t -> bool

is_private addr is a predicate indicating whether addr privately addresses a node.

val multicast_to_mac : t -> Macaddr.t

multicast_to_mac addr is the MAC address corresponding to the multicast address addr. See V4.multicast_to_mac and V6.multicast_to_mac.

val to_domain_name : t -> [ `host ] Domain_name.t

to_domain_name addr is the domain name label list for reverse lookups of addr. This includes the .in-addr.arpa or .ip6.arpa suffix.

val of_domain_name : 'a Domain_name.t -> t option

of_domain_name name is Some t if the name has an .in-addr.arpa or ip6.arpa suffix, and an IP address prefixed.

val succ : t -> (t, [> `Msg of string ]) Stdlib.result

succ addr is ip address next to addr. Returns a human-readable error string if it's already the highest address.

val pred : t -> (t, [> `Msg of string ]) Stdlib.result

pred addr is ip address before addr. Returns a human-readable error string if it's already the lowest address.

module Prefix : sig ... end
include Stdlib.Map.OrderedType with type t := t
val compare : t -> t -> int
module Set : Stdlib.Set.S with type elt := t
module Map : Stdlib.Map.S with type key := t