                              nss-ipv6literal 0.1

   Copyright 2009 Simo Sorce <idra (at) samba (dot) org>
     * [1]License
     * [2]News
     * [3]Overview
     * [4]Current Status
     * [5]Documentation
     * [6]Requirements
     * [7]Installation
     * [8]Acknowledgements
     * [9]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

   Sat Apr 04 2009:

   [10]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

   It works!

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 [11]nss-myhostname
   module

Download

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

   The current release is [13]0.1
     __________________________________________________________________


    Simo Sorce <idra (at) samba (dot) org>, Arpil 2009

References

   1. README#license
   2. README#news
   3. README#overview
   4. README#status
   5. README#documentation
   6. README#requirements
   7. README#installation
   8. README#acks
   9. README#download
  10. http://samba.org/~idra/code/nss-ipv6literal/nss-ipv6literal-0.1.tar.gz
  11. http://0pointer.de/lennart/projects/nss-myhostname/
  12. http://samba.org/~idra/code/nss-ipv6literal/
  13. http://samba.org/~idra/code/nss-ipv6literal/nss-ipv6literal-0.1.tar.gz
