---
name: "Geo::Mirror"
section: "3pm"
platform: "linux"
package: "libgeo-ip-perl"
version: "1.45-1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Geo::Mirror"
---

# Geo::Mirror(3pm)

Find closest Mirror

## NAME

Geo::Mirror - Find closest Mirror

## SYNOPSIS

```
  use Geo::Mirror;
  my $gm = Geo::Mirror->new(mirror_file => '/path/to/mirrors.txt');
  my $mirror = $gm->closest_mirror_by_country('us', $freshness);       # $freshness optional, see description below
  my $mirror = $gm->closest_mirror_by_addr('24.24.24.24', $freshness); # $freshness optional, see description below
```

## DESCRIPTION

This module finds the closest mirror for an IP address.  It uses Geo::IP to identify the country that the IP address originated from.  If the country is not represented in the mirror list, then it finds the closest country using a latitude/longitude table.

The mirror file should be a space separate list of URL, Country, and mirror freshness. The mirror freshness is optional and can be used by user request a mirror with a minimum freshness.

## AUTHOR

Copyright (c) 2004, MaxMind LLC, support@maxmind.com

All rights reserved.  This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself.