linux下使用man命令查看系统调用

我在阅读《linux系统编程》以及查看网上关于系统函数的博客时,老是看到诸如“详细使用请查看man手册”等等。作为linux菜鸟,刚使用linux时,我们都知道可以用man命令来查看linux命令的用法,但是却不知道怎么查看系统调用函数的用法。

方法是: man 2 read 或者是man 3 read。

中间的数字是什么意思呢?是man的分卷号,原来man分成很多部分,分别是:

1 用户命令, 可由任何人启动的。

2 系统调用, 即由内核提供的函数。

3 例程, 即库函数,比如标准C库libc。

4 设备, 即/dev目录下的特殊文件。

5 文件格式描述, 例如/etc/passwd。

6 游戏, 不用解释啦!

7 杂项, 例如宏命令包、惯例等。

8 系统管理员工具, 只能由root启动。

9 其他( Linux 特定的), 用来存放内核例行程序的文档。

n 新文档, 可能要移到更适合的领域。

o 老文档, 可能会在一段期限内保留。

l 本地文档, 与本特定系统有关的。

要查属于哪一部分的,就用哪一部分的编号在命令之前。

一般系统没有man命令,如果只安装man,就只能查看第一部分(命令),如

yum install man -y

如果要查看函数,也就是后面的部分,还需要安装man-pages

yum install man-pages -y

现在,就可以使用man 2 read 查看系统调用read的用法。 

[root@develop ~]# man 2 read |cat
READ(2)                    Linux Programmer’s Manual                   READ(2)



NAME
       read - read from a file descriptor

SYNOPSIS
       #include 

       ssize_t read(int fd, void *buf, size_t count);

DESCRIPTION
       read()  attempts to read up to count bytes from file descriptor fd into
       the buffer starting at buf.

       If count is zero, read() returns zero and has  no  other  results.   If
       count is greater than SSIZE_MAX, the result is unspecified.

RETURN VALUE
       On success, the number of bytes read is returned (zero indicates end of
       file), and the file position is advanced by this number.  It is not  an
       error  if  this  number  is smaller than the number of bytes requested;
       this may happen for example because fewer bytes are actually  available
       right  now  (maybe  because we were close to end-of-file, or because we
       are reading from a pipe, or from a terminal),  or  because  read()  was
       interrupted  by  a  signal.  On error, -1 is returned, and errno is set
       appropriately.  In this case it is left unspecified  whether  the  file
       position (if any) changes.

ERRORS
       EAGAIN The  file descriptor fd refers to a file other than a socket and
              has been marked non-blocking (O_NONBLOCK), and  the  read  would
              block.

       EAGAIN or EWOULDBLOCK
              The  file  descriptor  fd refers to a socket and has been marked
              non-blocking   (O_NONBLOCK),   and   the   read   would   block.
              POSIX.1-2001  allows  either error to be returned for this case,
              and does not require these constants to have the same value,  so
              a portable application should check for both possibilities.

       EBADF  fd is not a valid file descriptor or is not open for reading.

       EFAULT buf is outside your accessible address space.

       EINTR  The  call  was interrupted by a signal before any data was read;
              see signal(7).

       EINVAL fd is attached to an object which is unsuitable for reading;  or
              the  file  was  opened  with  the  O_DIRECT flag, and either the
              address specified in buf, the value specified in count,  or  the
              current file offset is not suitably aligned.

       EINVAL fd  was  created  via  a call to timerfd_create(2) and the wrong
              size buffer was given to read(); see timerfd_create(2) for  fur-
              ther information.

       EIO    I/O  error.  This will happen for example when the process is in
              a background process group, tries to read from  its  controlling
              tty,  and  either it is ignoring or blocking SIGTTIN or its pro-
              cess group is orphaned.  It may also occur when there is a  low-
              level I/O error while reading from a disk or tape.

       EISDIR fd refers to a directory.

       Other errors may occur, depending on the object connected to fd.  POSIX
       allows a read() that is interrupted after reading some data  to  return
       -1  (with  errno set to EINTR) or to return the number of bytes already
       read.

CONFORMING TO
       SVr4, 4.3BSD, POSIX.1-2001.

NOTES
       On NFS file systems, reading small amounts of data will only update the
       timestamp  the  first  time,  subsequent  calls may not do so.  This is
       caused by client side attribute caching, because most if  not  all  NFS
       clients  leave  st_atime  (last file access time) updates to the server
       and client side reads satisfied from the client’s cache will not  cause
       st_atime updates on the server as there are no server side reads.  Unix
       semantics can be obtained by disabling client side  attribute  caching,
       but in most situations this will substantially increase server load and
       decrease performance.

       Many file systems and disks were considered to be fast enough that  the
       implementation  of  O_NONBLOCK  was deemed unnecessary.  So, O_NONBLOCK
       may not be available on files and/or disks.

SEE ALSO
       close(2), fcntl(2), ioctl(2), lseek(2), open(2), pread(2),  readdir(2),
       readlink(2), readv(2), select(2), write(2), fread(3)

COLOPHON
       This  page  is  part of release 3.22 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.



Linux                             2009-02-23                           READ(2)
[root@develop ~]# 

而且,以前在使用man查看命令时,看到诸如 ioctl(2)这种表述,原来就算是指在man的卷2里查看。

SEE ALSO
       close(2), fcntl(2), ioctl(2), lseek(2), open(2), pread(2),  readdir(2),
       readlink(2), readv(2), select(2), write(2), fread(3)

如果觉得英语看起来费劲,可以安装中文支持

yum install man-pages-zh-CN -y

然后再修改系统默认语言

LANG=zh_CN.UTF-8  #临时生效

然后,再查看就是中文了。但是,中文只是部分支持,有些命令和函数也没有中文。

由于系统命令read 和 系统调用read() 重名了,以前只安装了man命令时,输入 "man read" 显示的是命令read的用法,现在安装了man-pages之后,使用man 2 read 是查看系统调用read()的用法。

不过,这毕竟是少数情况,对于只有系统调用名称的,如fork(), 输入"man  fork" 也是显示的系统调用fork()的用法。

 

当然,除了在系统上查看man手册,也可以从官网查看

http://man7.org/linux/man-pages/index.html

linux下使用man命令查看系统调用_第1张图片

你可能感兴趣的:(C,linux)