Return to ns.3 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man3

Annotation of 43BSDTahoe/man/man3/ns.3, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1986 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)ns.3n       6.2 (Berkeley) 5/12/86
        !             6: .\"
        !             7: .TH NS 3N "May 12, 1986"
        !             8: .UC 6
        !             9: .SH NAME
        !            10: ns_addr, ns_ntoa \- Xerox NS(tm)  address conversion routines
        !            11: .SH SYNOPSIS
        !            12: .nf
        !            13: .B "#include <sys/types.h>
        !            14: .B "#include <netns/ns.h>
        !            15: .PP
        !            16: .B "struct ns_addr ns_addr(cp)
        !            17: .B "char *cp;
        !            18: .PP
        !            19: .B "char *ns_ntoa(ns)
        !            20: .B "struct ns_addr ns;
        !            21: .fi
        !            22: .SH DESCRIPTION
        !            23: The routine
        !            24: .I ns_addr
        !            25: interprets character strings representing
        !            26: XNS addresses, returning binary information suitable
        !            27: for use in system calls.
        !            28: .I ns_ntoa
        !            29: takes XNS addresses and returns ASCII
        !            30: strings representing the address in a
        !            31: notation in common use in the Xerox Development Environment:
        !            32: .nf
        !            33:        <network number>.<host number>.<port number>
        !            34: .fi
        !            35: Trailing zero fields are suppressed, and each number is printed in hexadecimal,
        !            36: in a format suitable for input to 
        !            37: .IR ns_addr .
        !            38: Any fields lacking super-decimal digits will have a
        !            39: trailing ``H'' appended.
        !            40: .PP
        !            41: Unfortunately, no universal standard exists for representing XNS addresses.
        !            42: An effort has been made to insure that
        !            43: .I ns_addr
        !            44: be compatible with most formats in common use.
        !            45: It will first separate an address into 1 to 3 fields using a single delimiter
        !            46: chosen from
        !            47: period (``.''),
        !            48: colon (``:'') or pound-sign (``#'').
        !            49: Each field is then examined for byte separators (colon or period).
        !            50: If there are byte separators, each subfield separated is taken to be
        !            51: a small hexadecimal number, and the entirety is taken as a network-byte-ordered
        !            52: quantity to be zero extended in the high-network-order bytes.
        !            53: Next, the field is inspected for hyphens, in which case
        !            54: the field is assumed to be a number in decimal notation
        !            55: with hyphens separating the millenia.
        !            56: Next, the field is assumed to be a number:
        !            57: It is interpreted
        !            58: as hexadecimal if there is a leading ``0x'' (as in C),
        !            59: a trailing ``H'' (as in Mesa), or there are any super-decimal digits present.
        !            60: It is interpreted as octal is there is a leading ``0''
        !            61: and there are no super-octal digits.
        !            62: Otherwise, it is converted as a decimal number.
        !            63: .SH "SEE ALSO"
        !            64: hosts(5), networks(5),
        !            65: .SH DIAGNOSTICS
        !            66: None (see BUGS).
        !            67: .SH BUGS
        !            68: The string returned by
        !            69: .I ns_ntoa
        !            70: resides in a static memory area.
        !            71: .br
        !            72: .I ns_addr
        !            73: should diagnose improperly formed input, and there should be an unambiguous
        !            74: way to recognize this.

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