瀏覽代碼

+ Many fixed

michael 21 年之前
父節點
當前提交
a3e93b75ee
共有 1 個文件被更改,包括 41 次插入64 次删除
  1. 41 64
      docs/oldlinux.xml

+ 41 - 64
docs/oldlinux.xml

@@ -321,18 +321,6 @@ state at the moment a signal is sent to your program.
 <element name="TDir">
 <element name="TDir">
 <short>Record used in <link id="OpenDir"/> and <link id="ReadDir"/> calls </short>
 <short>Record used in <link id="OpenDir"/> and <link id="ReadDir"/> calls </short>
 </element>
 </element>
-<code>
-  TDir =record
-    fd     : integer;
-    loc    : longint;
-    size   : integer;
-    buf    : pdirent;
-    nextoff: longint;
-    dd_max : integer; 
-    lock   : pointer;
-  end;
-  PDir =^TDir;
-</code>
 <element name="TDir.fd">
 <element name="TDir.fd">
 <short>File descriptor. Do not use.</short>
 <short>File descriptor. Do not use.</short>
 </element>
 </element>
@@ -343,7 +331,7 @@ state at the moment a signal is sent to your program.
 <short>File size</short>
 <short>File size</short>
 </element>
 </element>
 <element name="TDir.buf">
 <element name="TDir.buf">
-<short>Pointer to <link id="TDirent"/> records</short>
+<short>Pointer to <link id="TDir"/> records</short>
 </element>
 </element>
 <element name="TDir.nextoff">
 <element name="TDir.nextoff">
 <short>?</short>
 <short>?</short>
@@ -538,44 +526,44 @@ the system unit for disgnostic messages.
 </element>
 </element>
 
 
 <element name="SA_NOCLDSTOP">
 <element name="SA_NOCLDSTOP">
-<short>Signal flags: No child stop</short>
+<short>Sigaction options: Do not receive notification when child processes stop</short>
 </element>
 </element>
 <element name="SA_SHIRQ">
 <element name="SA_SHIRQ">
-<short>Signal flags: </short>
+<short>Sigaction options: ?</short>
 </element>
 </element>
 <element name="SA_STACK">
 <element name="SA_STACK">
-<short>Signal flags: </short>
+<short>Sigaction options: Call the signal handler on an alternate signal stack.</short>
 </element>
 </element>
 <element name="SA_RESTART">
 <element name="SA_RESTART">
-<short>Signal flags: </short>
+<short>Sigaction options: Provide behaviour compatible with BSD signal semantics</short>
 </element>
 </element>
 <element name="SA_INTERRUPT">
 <element name="SA_INTERRUPT">
-<short>Signal flags: </short>
+<short>Sigaction options: ?</short>
 </element>
 </element>
 <element name="SA_NOMASK">
 <element name="SA_NOMASK">
-<short>Signal flags: </short>
+<short>Sigaction options: Do not prevent the signal from being received when it is handled.</short>
 </element>
 </element>
 <element name="SA_ONESHOT">
 <element name="SA_ONESHOT">
-<short>Signal flags: </short>
+<short>Sigaction options: Restore the signal action to the default state.</short>
 </element>
 </element>
 
 
 <element name="SIG_BLOCK">
 <element name="SIG_BLOCK">
-<short>Signal flags: </short>
+<short>Sigprocmask flags: Add signals to the set of blocked signals.</short>
 </element>
 </element>
 <element name="SIG_UNBLOCK">
 <element name="SIG_UNBLOCK">
-<short>Signal flags: </short>
+<short>Sigprocmask flags: Remove signals from the set set of blocked signals.</short>
 </element>
 </element>
 <element name="SIG_SETMASK">
 <element name="SIG_SETMASK">
-<short>Signal flags: </short>
+<short>Sigprocmask flags: Set of blocked signals is given.</short>
 </element>
 </element>
 <element name="SIG_DFL">
 <element name="SIG_DFL">
-<short>Signal flags: Default signal</short>
+<short>Signal handler: Default signal handler</short>
 </element>
 </element>
 <element name="SIG_IGN">
 <element name="SIG_IGN">
-<short>Signal flags: Ignore signal</short>
+<short>Signal handler: Ignore signal</short>
 </element>
 </element>
 <element name="SIG_ERR">
 <element name="SIG_ERR">
-<short>Signal flags: error</short>
+<short>Signal handler: error</short>
 </element>
 </element>
 
 
 <element name="SIGHUP">
 <element name="SIGHUP">
@@ -1145,8 +1133,8 @@ Auxiliary functions that are useful in connection with the other functions.
 <short>Check file access</short>
 <short>Check file access</short>
 <descr>
 <descr>
 <p>
 <p>
-Tests user's access rights on the specified file. Mode is a mask existing of
-one or more of
+<var>Access</var> tests user's access rights on the specified file. 
+<var>Mode</var> is a mask existing of one or more of the following:
 </p>
 </p>
 <dl>
 <dl>
 <dt>R_OK</dt><dd>User has read rights.</dd>
 <dt>R_OK</dt><dd>User has read rights.</dd>
@@ -1191,7 +1179,7 @@ dangling symbolic link.</dd>
 <short>Schedule an alarm signal to be delivered</short>
 <short>Schedule an alarm signal to be delivered</short>
 <descr>
 <descr>
 <p>
 <p>
-Alarm schedules an alarm signal to be delivered to your process in <var>Sec</var>
+<var>Alarm</var> schedules an alarm signal to be delivered to your process in <var>Sec</var>
 seconds. When <var>Sec</var> seconds have elapsed, Linux will send a <var>SIGALRM</var>
 seconds. When <var>Sec</var> seconds have elapsed, Linux will send a <var>SIGALRM</var>
 signal to the current process.  If <var>Sec</var> is zero, then no new alarm will
 signal to the current process.  If <var>Sec</var> is zero, then no new alarm will
 be set. Whatever the value of <var>Sec</var>, any previous alarm is cancelled.
 be set. Whatever the value of <var>Sec</var>, any previous alarm is cancelled.
@@ -1381,8 +1369,8 @@ None.
 <element name="Chown">
 <element name="Chown">
 <short>Change owner of file</short>
 <short>Change owner of file</short>
 <descr>
 <descr>
-<var>Chown</var> sets the User ID and Group ID of the file in <var>Path</var> to \var{NewUid,
-NewGid}.
+<var>Chown</var> sets the User ID and Group ID of the file in <var>Path</var> to
+<var>NewUid</var>, <var>NewGid</var>
 The function returns <var>True</var> if the call was succesfull, <var>False</var> if the call
 The function returns <var>True</var> if the call was succesfull, <var>False</var> if the call
 failed.
 failed.
 </descr>
 </descr>
@@ -1400,9 +1388,6 @@ search (=execute) permission.</dd>
 <dt>sys_enoent</dt>
 <dt>sys_enoent</dt>
 <dd> A directory entry in <var>Path</var> does
 <dd> A directory entry in <var>Path</var> does
 not exist or is a symbolic link pointing to a non-existent directory.</dd>
 not exist or is a symbolic link pointing to a non-existent directory.</dd>
-<dt>sys_enotdir</dt>
-<dd> A directory entry in <var>OldPath</var> or <var>NewPath</var> is
-nor a directory.</dd>
 <dt>sys_enomem</dt>
 <dt>sys_enomem</dt>
 <dd> Insufficient kernel memory.</dd>
 <dd> Insufficient kernel memory.</dd>
 <dt>sys_erofs</dt>
 <dt>sys_erofs</dt>
@@ -1460,9 +1445,6 @@ search (=execute) permission.</dd>
 <dt>sys_enoent</dt>
 <dt>sys_enoent</dt>
 <dd> A directory entry in <var>Path</var> does
 <dd> A directory entry in <var>Path</var> does
 not exist or is a symbolic link pointing to a non-existent directory.</dd>
 not exist or is a symbolic link pointing to a non-existent directory.</dd>
-<dt>sys_enotdir</dt>
-<dd> A directory entry in <var>OldPath</var> or <var>NewPath</var> is
-nor a directory.</dd>
 <dt>sys_enomem</dt>
 <dt>sys_enomem</dt>
 <dd> Insufficient kernel memory.</dd>
 <dd> Insufficient kernel memory.</dd>
 <dt>sys_erofs</dt>
 <dt>sys_erofs</dt>
@@ -1619,7 +1601,7 @@ None.
 Makes <var>NewFile</var> an exact copy of <var>OldFile</var>, after having flushed the
 Makes <var>NewFile</var> an exact copy of <var>OldFile</var>, after having flushed the
 buffer of <var>OldFile</var> in case it is a Text file or untyped file. 
 buffer of <var>OldFile</var> in case it is a Text file or untyped file. 
 Due to the buffering mechanism of Pascal, this has not the same functionality
 Due to the buffering mechanism of Pascal, this has not the same functionality
-as the \seem{dup}{2} call in C. The internal Pascal buffers are not the same 
+as the dup call in C. The internal Pascal buffers are not the same 
 after this call, but when the buffers are flushed (e.g. after output), 
 after this call, but when the buffers are flushed (e.g. after output), 
 the output is sent to the same file.
 the output is sent to the same file.
 Doing an lseek will, however, work as in C, i.e. doing a lseek will change 
 Doing an lseek will, however, work as in C, i.e. doing a lseek will change 
@@ -1870,8 +1852,6 @@ A compononent of the path has no search permission.</dd>
 <example file="olinuxex/ex8"/>
 <example file="olinuxex/ex8"/>
 </element>
 </element>
 
 
-
-
 <element name="Execve">
 <element name="Execve">
 <short>Execute process using environment</short>
 <short>Execute process using environment</short>
 <descr>
 <descr>
@@ -1887,16 +1867,16 @@ On success, <var>execve</var> does not return.
 Errors are reported in <var>LinuxError</var>:
 Errors are reported in <var>LinuxError</var>:
 </p>
 </p>
 <dl>
 <dl>
-<dt>eacces</dt>
+<dt>sys_eacces</dt>
 <dd> File is not a regular file, or has no execute permission.
 <dd> File is not a regular file, or has no execute permission.
 A compononent of the path has no search permission.</dd>
 A compononent of the path has no search permission.</dd>
-<dt>sys_ eperm</dt><dd> The file system is mounted \textit{noexec}.</dd>
-<dt>sys_ e2big</dt><dd> Argument list too big.</dd>
-<dt>sys_ enoexec</dt><dd> The magic number in the file is incorrect.</dd>
-<dt>sys_ enoent</dt><dd> The file does not exist.</dd>
-<dt>sys_ enomem</dt><dd> Not enough memory for kernel.</dd>
-<dt>sys_ enotdir</dt><dd> A component of the path is not a directory.</dd>
-<dt>sys_ eloop</dt><dd> The path contains a circular reference (via symlinks).</dd>
+<dt>sys_eperm</dt><dd> The file system is mounted \textit{noexec}.</dd>
+<dt>sys_e2big</dt><dd> Argument list too big.</dd>
+<dt>sys_enoexec</dt><dd> The magic number in the file is incorrect.</dd>
+<dt>sys_enoent</dt><dd> The file does not exist.</dd>
+<dt>sys_enomem</dt><dd> Not enough memory for kernel.</dd>
+<dt>sys_enotdir</dt><dd> A component of the path is not a directory.</dd>
+<dt>sys_eloop</dt><dd> The path contains a circular reference (via symlinks).</dd>
 </dl>
 </dl>
 </errors>
 </errors>
 <seealso>
 <seealso>
@@ -2153,7 +2133,7 @@ Errors are returned in LinuxError.
 <link id="fdClose"/>
 <link id="fdClose"/>
 <link id="fdRead"/>
 <link id="fdRead"/>
 <link id="fdWrite"/>
 <link id="fdWrite"/>
-<link id="fdTruncate"/>,
+<link id="fdTruncate"/>
 <link id="fdFlush"/>
 <link id="fdFlush"/>
 <link id="fdSeek"/>
 <link id="fdSeek"/>
 </seealso>
 </seealso>
@@ -2461,7 +2441,7 @@ obstruction. Arg is a pointer to a flock record.
 occurs.
 occurs.
 </dd>
 </dd>
 <dt>F_GetLkw</dt>
 <dt>F_GetLkw</dt>
-<dd> Same as for \textbf{F_Setlk}, but wait until the lock is
+<dd> Same as for <b>F_Setlk</b>, but wait until the lock is
 released.
 released.
 </dd>
 </dd>
 <dt>F_SetOwn</dt>
 <dt>F_SetOwn</dt>
@@ -2484,8 +2464,8 @@ held by another process.</dd>
 <element name="Fork">
 <element name="Fork">
 <short>Create child process</short>
 <short>Create child process</short>
 <descr>
 <descr>
-Fork creates a child process which is a copy of the parent process.
-Fork returns the process ID in the parent process, and zero in the child's
+<var>Fork</var> creates a child process which is a copy of the parent process.
+<var>Fork</var> returns the process ID in the parent process, and zero in the child's
 process. (you can get the parent's PID with <link id="GetPPid"/>).
 process. (you can get the parent's PID with <link id="GetPPid"/>).
 </descr>
 </descr>
 <errors>
 <errors>
@@ -2642,7 +2622,7 @@ Get the effective user ID of the currently running process.
 None.
 None.
 </errors>
 </errors>
 <seealso>
 <seealso>
-<link id="GetEUid"/>
+<link id="GetUid"/>
 </seealso>
 </seealso>
 <example file="olinuxex/ex17"/>
 <example file="olinuxex/ex17"/>
 </element>
 </element>
@@ -2652,9 +2632,9 @@ None.
 <short>Return value of environment variable.</short>
 <short>Return value of environment variable.</short>
 <descr>
 <descr>
 <p>
 <p>
-Returns the value of the environment variable in <var>P</var>. If the variable is
-not defined, nil is returned. The value of the environment variable may be
-the empty string.
+<var>GetEnv</var> returns the value of the environment variable in <var>P</var>. 
+If the variable is not defined, nil is returned. The value of the environment 
+variable may be the empty string.
 A PChar is returned to accomodate for strings longer than 255 bytes,
 A PChar is returned to accomodate for strings longer than 255 bytes,
 <var>TERMCAP</var> and <var>LS_COLORS</var>, for instance.
 <var>TERMCAP</var> and <var>LS_COLORS</var>, for instance.
 </p>
 </p>
@@ -2662,7 +2642,7 @@ A PChar is returned to accomodate for strings longer than 255 bytes,
 <errors>
 <errors>
 None.
 None.
 </errors>
 </errors>
-<example file="olinuxex/ex41"/>
+<example file="linuxex/ex41"/>
 </element>
 </element>
 
 
 
 
@@ -2962,9 +2942,6 @@ For more information on this, see various manual pages under linux.
 Errors are reported in LinuxError. They are very dependent on the used
 Errors are reported in LinuxError. They are very dependent on the used
 function, that's why we don't list them here
 function, that's why we don't list them here
 </errors>
 </errors>
-<seealso>
-\seem{ioctl}{2}
-</seealso>
 <example file="olinuxex/ex54"/>
 <example file="olinuxex/ex54"/>
 </element>
 </element>
 
 
@@ -3263,7 +3240,7 @@ None
 <short>Create FIFO (named pipe) in file system</short>
 <short>Create FIFO (named pipe) in file system</short>
 <descr>
 <descr>
 <var>MkFifo</var> creates named a named pipe in the filesystem, with name
 <var>MkFifo</var> creates named a named pipe in the filesystem, with name
-<var>PathName</var> and mode {Mode}.
+<var>PathName</var> and mode <var>Mode</var>.
 </descr>
 </descr>
 <errors>
 <errors>
 <p>
 <p>
@@ -3276,7 +3253,7 @@ None
 </errors>
 </errors>
 <seealso>
 <seealso>
 <link id="POpen"/>
 <link id="POpen"/>
-<link id="MkFifo"/>, \seem{mkfifo}{4}
+<link id="MkFifo"/>
 </seealso>
 </seealso>
 </element>
 </element>
 
 
@@ -3407,7 +3384,7 @@ and <var>LinuxError</var> is set to <var>EINVAL</var>.
 <link id="Pause"/>
 <link id="Pause"/>
 <link id="Alarm"/>
 <link id="Alarm"/>
 </seealso>
 </seealso>
-<example file="olinuxex/ex70"/>
+<example file="olinuxex/ex72"/>
 </element>
 </element>
 
 
 
 
@@ -3986,7 +3963,7 @@ None
 <short>Install signal handler (deprecated)</short>
 <short>Install signal handler (deprecated)</short>
 <descr>
 <descr>
 <p>
 <p>
-Signal installs a new signal handler for signal <var>SigNum</var>. This call has
+<var>Signal</var> installs a new signal handler for signal <var>SigNum</var>. This call has
 the same functionality as the <b>SigAction</b> call.
 the same functionality as the <b>SigAction</b> call.
 The return value for Signal is the old signal handler, or nil on error.
 The return value for Signal is the old signal handler, or nil on error.
 </p>
 </p>