Table of contents

• License
• News
• Overview
• Current Status
• Documentation
• Requirements
• Installation
• Acknowledgements
• Download

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 2.1 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

News

Version 0.3 Fix a segfault.

Version 0.2 Added a couple more features. Now it resolves FQDNs with a trailing dot and zone indexes in the form of an interface name (works on Linux)

Version 0.1 First release.

Overview

nss-ipv6literal is a module for the Name Service Switch (NSS) providing host name resolution for Microsoft style ipv6 literal DNS names. In windows UNC path names cannot contain the : character. Therefore MS has reserved a second level domain name (ipv6-literal.net), that is used to resolve ipv6 translated addresses so that an ipv6 address can actually be used (albeit as a hack) in an UNC string. All : characters are translated into - and the scope-id is added to the address after the s character.

Example: FE80::1%1 is transalted as FE80--1s1.ipv6-literal.net

Current Status

Works for me.

Documentation

After compiling and installing nss-ipv6literal you'll find it in your system library directory with the name:

• libnss_ipv6literal.so.2

To use this module add it to the hosts parameter of the /etc/nsswitch.conf file.

# /etc/nsswitch.conf

hosts:          files ipv6literal dns

Put it before the dns module so that ipv6-literal names are resolved locally and are not requested over the wire with a slow DNS call.

You can use the getent tool to test it:

$ getent hosts fe80--1s1.ipv6-literal.net
fe80::1         fe80--1s1.ipv6-literal.net

Requirements

nss-ipv6literal has been developed and tested on Fedora 10, but it should work on most other Linux distributions since it uses GNU autoconf and GNU libtool for source code configuration and shared library management.

Installation

As this package is made with the GNU autotools you should run ./configure inside the distribution directory for configuring the source tree. After that you should run make for compilation and make install (as root) for installation of nss-ipv6literal.

Acknowledgements

Source structure and build system based on Lennart's nss-myhostname module

Download

The newest release is always available from http://samba.org/~idra/code/nss-ipv6literal/

The current release is 0.3

---

Simo Sorce <idra@samba.org>, June 2009