share/man/man4/protocols.4

   1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (C) 2002, Sun Microsystems, Inc. All Rights Reserved
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH PROTOCOLS 4 "Feb 25, 2017"
   8 .SH NAME
   9 protocols \- protocol name database
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/etc/inet/protocols\fR
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fB/etc/protocols\fR
  19 .fi
  20
  21 .SH DESCRIPTION
  22 .LP
  23 The \fBprotocols\fR file  is a local source of information regarding the known
  24 protocols used in the \fBDARPA\fR Internet. The protocols file can be used in
  25 conjunction with or instead of other protocols sources, including the \fBNIS\fR
  26 maps "protocols.byname" and "protocols.bynumber". Programs use the
  27 \fBgetprotobyname\fR(3SOCKET) routine to access this information.
  28 .sp
  29 .LP
  30 The \fBprotocols\fR file has one line for each protocol. The line has the
  31 following format:
  32 .sp
  33 .in +2
  34 .nf
  35 \fIofficial-protocol-name\fR \fIprotocol-number\fR \fIaliases\fR
  36 .fi
  37 .in -2
  38
  39 .sp
  40 .LP
  41 Items are separated by any number of blanks and/or TAB characters. A `\fB#\fR'
  42 indicates the beginning of a comment; characters up to the end of the line are
  43 not interpreted by routines which search the file. Protocol names may contain
  44 any printable character other than a field delimiter, NEWLINE, or comment
  45 character.
  46 .SH EXAMPLES
  47 .LP
  48 \fBExample 1 \fRA Sample Database
  49 .sp
  50 .LP
  51 The following is a sample database:
  52
  53 .sp
  54 .in +2
  55 .nf
  56 #
  57 # Internet (IP) protocols
  58 #
  59 ip          0   IP          # internet protocol, pseudo protocol number
  60 icmp        1   ICMP        # internet control message protocol
  61 ggp         3   GGP         # gateway-gateway protocol
  62 tcp         6   TCP         # transmission control protocol
  63 egp         8   EGP         # exterior gateway protocol
  64 pup         12  PUP         # PARC universal packet protocol
  65 udp         17  UDP         # user datagram protocol
  66
  67 #
  68 # Internet (IPv6) extension headers
  69 #
  70 hopopt      0   HOPOPT      # Hop-by-hop options for IPv6
  71 ipv6        41  IPv6        # IPv6 in IP encapsulation
  72 ipv6-route  43  IPv6-Route  # Routing header for IPv6
  73 ipv6-frag   44  IPv6-Frag   # Fragment header for IPv6
  74 esp         50  ESP         # Encap Security Payload for IPv6
  75 ah          51  AH          # Authentication Header for IPv6
  76 ipv6-icmp   58  IPv6-ICMP   # IPv6 internet control message protocol
  77 ipv6-nonxt  59  IPv6-NoNxt  # No next header extension header for IPv6
  78 ipv6-opts   60  IPv6-Opts   # Destination Options for IPv6
  79 .fi
  80 .in -2
  81 .sp
  82
  83 .SH FILES
  84 .ne 2
  85 .na
  86 \fB\fB/etc/nsswitch.conf\fR\fR
  87 .ad
  88 .RS 22n
  89 configuration file for name-service switch
  90 .RE
  91
  92 .SH SEE ALSO
  93 .LP
  94 \fBgetprotobyname\fR(3SOCKET), \fBnsswitch.conf\fR(4)
  95 .SH NOTES
  96 .LP
  97 \fB/etc/inet/protocols\fR is the official SVR4 name of the \fBprotocols\fR
  98 file.  The symbolic link \fB/etc/protocols\fR exists for \fBBSD\fR
  99 compatibility.