Return to ns.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / net

Annotation of 43BSDReno/lib/libc/net/ns.3, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1986 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"    @(#)ns.3        6.4 (Berkeley) 6/23/90
        !            19: .\"
        !            20: .TH NS 3 "June 23, 1990"
        !            21: .UC 6
        !            22: .SH NAME
        !            23: ns_addr, ns_ntoa \- Xerox NS(tm)  address conversion routines
        !            24: .SH SYNOPSIS
        !            25: .nf
        !            26: .B "#include <sys/types.h>
        !            27: .B "#include <netns/ns.h>
        !            28: .PP
        !            29: .B "struct ns_addr ns_addr(cp)
        !            30: .B "char *cp;
        !            31: .PP
        !            32: .B "char *ns_ntoa(ns)
        !            33: .B "struct ns_addr ns;
        !            34: .fi
        !            35: .SH DESCRIPTION
        !            36: The routine
        !            37: .I ns_addr
        !            38: interprets character strings representing
        !            39: XNS addresses, returning binary information suitable
        !            40: for use in system calls.
        !            41: .I ns_ntoa
        !            42: takes XNS addresses and returns ASCII
        !            43: strings representing the address in a
        !            44: notation in common use in the Xerox Development Environment:
        !            45: .nf
        !            46:        <network number>.<host number>.<port number>
        !            47: .fi
        !            48: Trailing zero fields are suppressed, and each number is printed in hexadecimal,
        !            49: in a format suitable for input to 
        !            50: .IR ns_addr .
        !            51: Any fields lacking super-decimal digits will have a
        !            52: trailing ``H'' appended.
        !            53: .PP
        !            54: Unfortunately, no universal standard exists for representing XNS addresses.
        !            55: An effort has been made to insure that
        !            56: .I ns_addr
        !            57: be compatible with most formats in common use.
        !            58: It will first separate an address into 1 to 3 fields using a single delimiter
        !            59: chosen from
        !            60: period (``.''),
        !            61: colon (``:'') or pound-sign (``#'').
        !            62: Each field is then examined for byte separators (colon or period).
        !            63: If there are byte separators, each subfield separated is taken to be
        !            64: a small hexadecimal number, and the entirety is taken as a network-byte-ordered
        !            65: quantity to be zero extended in the high-network-order bytes.
        !            66: Next, the field is inspected for hyphens, in which case
        !            67: the field is assumed to be a number in decimal notation
        !            68: with hyphens separating the millenia.
        !            69: Next, the field is assumed to be a number:
        !            70: It is interpreted
        !            71: as hexadecimal if there is a leading ``0x'' (as in C),
        !            72: a trailing ``H'' (as in Mesa), or there are any super-decimal digits present.
        !            73: It is interpreted as octal is there is a leading ``0''
        !            74: and there are no super-octal digits.
        !            75: Otherwise, it is converted as a decimal number.
        !            76: .SH "SEE ALSO"
        !            77: hosts(5), networks(5),
        !            78: .SH DIAGNOSTICS
        !            79: None (see BUGS).
        !            80: .SH BUGS
        !            81: The string returned by
        !            82: .I ns_ntoa
        !            83: resides in a static memory area.
        !            84: .br
        !            85: .I ns_addr
        !            86: should diagnose improperly formed input, and there should be an unambiguous
        !            87: way to recognize this.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.