File: 500-notes.html

package info (click to toggle)
libexplain 1.4.D001-16
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 42,228 kB
  • sloc: ansic: 156,043; makefile: 47,892; sh: 16,304; yacc: 1,898; awk: 245
file content (150 lines) | stat: -rw-r--r-- 4,798 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<!--
  libexplain - Explain errno values returned by libc functions
  Copyright (C) 2009, 2010 Peter Miller
  Written by Peter Miller <pmiller@opensource.org.au>

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 3 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
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program. If not, see <http://www.gnu.org/licenses/>.
-->
.hy 0
.ad l
<!DOCTYPE HTML PUBLIC
    "-//W3C//DTD HTML 4.01 Transitional//EN"
    "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd"
    >
.nf
<html>
<head>
<title>
No medium Found, 5.0, Notes
</title>
</head>
<body>

<table width="100%" >
<tr>
    <td align="left" >
        <a href="400-notes.html" >Prev</a>,
        <a href="000-notes.html" >Top</a>
    </td><td align="right" >
        <a href="500-slide.html" >Slide</a>,
        <a href="600-notes.html" >Next</a>
    </td>
</tr>
</table>

<h1>
5. Strange and Interesting System Calls
</h1>

<ul>
<li> one strerror-equivalent per system call
<li> boundary conditions
<li> multiple causes for the same <i>errno</i> value
<li> multiple <i>errno</i> values for the same cause
<li> coders@slug mailing list
</ul>

<h2> <a name="5.1">5.1</a> ENOMEDIUM </h2>
<ul>
<li> of course, they are all frauds; <a href="500-slide.html" >slide</a>
<li> Native English speakers don't know that &ldquo;media&rdquo; is a plural,
     let alone that &ldquo;medium&rdquo; is its singular.
<li> this <i>strerror</i>(3) string is almost content-free.
<li> surely this could be more informative; <a href="510-slide.html" >slide</a>
<li> O_NONBLOCK
<li> it also groks floppies, magnetic tapes, MMC card readers, <i>etc</i>
<li> disc-with-a-c <i>vs</i> disk-with-a-k
</ul>

<h2> <a name="5.2">5.2</a> EFAULT </h2>
<ul>
<li> one pointer is easy; <a href="520-slide.html" >slide</a>
<li> must not disturb process (thread) signal handlers
<li> bounded memory: <i>mincore</i>(2)
<li> strings: <i>lstat</i>(2)
</ul>

<h2> <a name="5.3">5.3</a> EMFILE </h2>
<ul>
<li> The message includes the limit; <a href="530-slide.html" >slide</a>
<li> can't use <tt>/proc</tt>
<li> <i>sysconf</i>(3) is very handy
<li> of course, it could be a single-open device that
     is already open or mounted
</ul>

<h2> <a name="5.4">5.4</a> ENFILE </h2>
<ul>
<li> The message includes the limit; <a href="540-slide.html" >slide</a>
<li> can't use <tt>/proc</tt>
<li> <i>sysconf</i>(3) is very handy
<li> this is when you read kernel sources
<li> system call with no [e]glibc binding<br>
     <tt>CTL_FS, FS_MAXFILE</tt>
</ul>

<h2> <a name="5.5">5.5</a> EPERM <i>vs</i> ENOSYS </h2>
<ul>
<li> also EINVAL sometimes
<li> same cause, different <i>errno</i>(3) values;
     <a href="550-slide.html" >slide</a>
<li> same <i>errno</i>(3) value, different causes;
     <a href="551-slide.html" >slide</a>
<li> wishlist: pathconf for "is this fops pointer non-null"
</ul>

<h2> <a name="5.6">5.6</a> <i>errno</i>(3) is not always set </h2>
<ul>
<li> <a href="560-slide.html" >slide</a>
<li> <i>somtimes</i> they set <i>errno</i>(3),
     sometimes they don't.
<li> traps for young players (old ones, too)
<li> not going into each one, read the paper
<li> who knew that <i>fileno</i>(3) could fail?
</ul>

<h2> <a name="5.7">5.7</a> ENOSPC </h2>
<ul>
<li> <a href="570-slide.html" >slide</a>
<li> print the mount point
<li> work in progress (inodes vs data vs directory entries)
<li> special devices already includes device name...
<li> &...need to add device size, without altering state
</ul>

<h2> <a name="5.8">5.8</a> EROFS </h2>
<ul>
<li> file systems print the mount point; <a href="580-slide.html" >slide</a>
<li> devices are more specific
<li> work in progress: filesys case could drill down
<li> work in progress: not all devices this accurate<br/>
\&...because a CD-ROM is not writable<br/>
\&...because the memory card has the write protect tab set<br/>
\&...because the &frac12; inch magnetic tape does not have a write ring<br/>
</ul>

<h2> <a name="5.9">5.9</a> <i>rename</i>(2) </h2>
<ul>
<li> not talking about <i>mv</i><(1)
<li> <i>rename</i>(2) directory over directory;
     <a href="590-slide.html" >slide</a>
<li> destination must be empty
<li> implies all the <i>rmdir</i>(2) errors as well
<li> but not files over directories, or <i>vice versa</i>
<li> who knew: <i>dup2</i>(2) is the same
<li> ...implies all the <i>unlink</i>(2) errors as well
</ul>

</body>
</html>