OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [net-common-tcpip-manpages-link-addr.html] - Blame information for rev 588

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 28 unneback
<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
2
<!-- This material may be distributed only subject to the terms      -->
3
<!-- and conditions set forth in the Open Publication License, v1.0  -->
4
<!-- or later (the latest version is presently available at          -->
5
<!-- http://www.opencontent.org/openpub/).                           -->
6
<!-- Distribution of the work or derivative of the work in any       -->
7
<!-- standard (paper) book form is prohibited unless prior           -->
8
<!-- permission is obtained from the copyright holder.               -->
9
<HTML
10
><HEAD
11
><TITLE
12
>link_addr</TITLE
13
><meta name="MSSmartTagsPreventParsing" content="TRUE">
14
<META
15
NAME="GENERATOR"
16
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
17
"><LINK
18
REL="HOME"
19
TITLE="eCos Reference Manual"
20
HREF="ecos-ref.html"><LINK
21
REL="UP"
22
TITLE="TCP/IP Library Reference"
23
HREF="tcpip-library-reference.html"><LINK
24
REL="PREVIOUS"
25
TITLE="iso_addr"
26
HREF="net-common-tcpip-manpages-iso-addr.html"><LINK
27
REL="NEXT"
28
TITLE="net_addrcmp"
29
HREF="net-common-tcpip-manpages-net-addrcmp.html"></HEAD
30
><BODY
31
CLASS="SECT1"
32
BGCOLOR="#FFFFFF"
33
TEXT="#000000"
34
LINK="#0000FF"
35
VLINK="#840084"
36
ALINK="#0000FF"
37
><DIV
38
CLASS="NAVHEADER"
39
><TABLE
40
SUMMARY="Header navigation table"
41
WIDTH="100%"
42
BORDER="0"
43
CELLPADDING="0"
44
CELLSPACING="0"
45
><TR
46
><TH
47
COLSPAN="3"
48
ALIGN="center"
49
>eCos Reference Manual</TH
50
></TR
51
><TR
52
><TD
53
WIDTH="10%"
54
ALIGN="left"
55
VALIGN="bottom"
56
><A
57
HREF="net-common-tcpip-manpages-iso-addr.html"
58
ACCESSKEY="P"
59
>Prev</A
60
></TD
61
><TD
62
WIDTH="80%"
63
ALIGN="center"
64
VALIGN="bottom"
65
>Chapter 38. TCP/IP Library Reference</TD
66
><TD
67
WIDTH="10%"
68
ALIGN="right"
69
VALIGN="bottom"
70
><A
71
HREF="net-common-tcpip-manpages-net-addrcmp.html"
72
ACCESSKEY="N"
73
>Next</A
74
></TD
75
></TR
76
></TABLE
77
><HR
78
ALIGN="LEFT"
79
WIDTH="100%"></DIV
80
><DIV
81
CLASS="SECT1"
82
><H1
83
CLASS="SECT1"
84
><A
85
NAME="NET-COMMON-TCPIP-MANPAGES-LINK-ADDR">link_addr</H1
86
><TABLE
87
BORDER="5"
88
BGCOLOR="#E0E0F0"
89
WIDTH="70%"
90
><TR
91
><TD
92
><PRE
93
CLASS="SCREEN"
94
>LINK_ADDR(3)            System Library Functions Manual           LINK_ADDR(3)
95
 
96
NAME
97
     link_addr, link_ntoa - elementary address specification routines for link
98
     level access
99
 
100
SYNOPSIS
101
     #include &lt;sys/types.h&#62;
102
     #include &lt;sys/socket.h&#62;
103
     #include &lt;net/if_dl.h&#62;
104
 
105
     void
106
     link_addr(const char *addr, struct sockaddr_dl *sdl);
107
 
108
     char *
109
     link_ntoa(const struct sockaddr_dl *sdl);
110
 
111
DESCRIPTION
112
     The link_addr() function interprets character strings representing link-
113
     level addresses, returning binary information suitable for use in system
114
     calls.  link_ntoa() takes a link-level address and returns an ASCII
115
     string representing some of the information present, including the link
116
     level address itself, and the interface name or number, if present.  This
117
     facility is experimental and is still subject to change.
118
 
119
     For link_addr(), the string addr may contain an optional network inter-
120
     face identifier of the form ``name unit-number'', suitable for the first
121
     argument to ifconfig(8), followed in all cases by a colon and an inter-
122
     face address in the form of groups of hexadecimal digits separated by
123
     periods.  Each group represents a byte of address; address bytes are
124
     filled left to right from low order bytes through high order bytes.
125
 
126
     Thus le0:8.0.9.13.d.30 represents an Ethernet address to be transmitted
127
     on the first Lance Ethernet interface.
128
 
129
RETURN VALUES
130
     link_ntoa() always returns a null-terminated string.  link_addr() has no
131
     return value.  (See BUGS.)
132
 
133
SEE ALSO
134
     iso(4), ifconfig(8)
135
 
136
HISTORY
137
     The link_addr() and link_ntoa() functions appeared in 4.3BSD-Reno.
138
 
139
BUGS
140
     The returned values for link_ntoa reside in a static memory area.
141
 
142
     The function link_addr() should diagnose improperly formed input, and
143
     there should be an unambiguous way to recognize this.
144
 
145
     If the sdl_len field of the link socket address sdl is 0, link_ntoa()
146
     will not insert a colon before the interface address bytes.  If this
147
     translated address is given to link_addr() without inserting an initial
148
     colon, the latter will not interpret it correctly.
149
 
150
BSD                              July 28, 1993                             BSD
151
    </PRE
152
></TD
153
></TR
154
></TABLE
155
></DIV
156
><DIV
157
CLASS="NAVFOOTER"
158
><HR
159
ALIGN="LEFT"
160
WIDTH="100%"><TABLE
161
SUMMARY="Footer navigation table"
162
WIDTH="100%"
163
BORDER="0"
164
CELLPADDING="0"
165
CELLSPACING="0"
166
><TR
167
><TD
168
WIDTH="33%"
169
ALIGN="left"
170
VALIGN="top"
171
><A
172
HREF="net-common-tcpip-manpages-iso-addr.html"
173
ACCESSKEY="P"
174
>Prev</A
175
></TD
176
><TD
177
WIDTH="34%"
178
ALIGN="center"
179
VALIGN="top"
180
><A
181
HREF="ecos-ref.html"
182
ACCESSKEY="H"
183
>Home</A
184
></TD
185
><TD
186
WIDTH="33%"
187
ALIGN="right"
188
VALIGN="top"
189
><A
190
HREF="net-common-tcpip-manpages-net-addrcmp.html"
191
ACCESSKEY="N"
192
>Next</A
193
></TD
194
></TR
195
><TR
196
><TD
197
WIDTH="33%"
198
ALIGN="left"
199
VALIGN="top"
200
>iso_addr</TD
201
><TD
202
WIDTH="34%"
203
ALIGN="center"
204
VALIGN="top"
205
><A
206
HREF="tcpip-library-reference.html"
207
ACCESSKEY="U"
208
>Up</A
209
></TD
210
><TD
211
WIDTH="33%"
212
ALIGN="right"
213
VALIGN="top"
214
>net_addrcmp</TD
215
></TR
216
></TABLE
217
></DIV
218
></BODY
219
></HTML
220
>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.