Chinaunix

标题: 求教一段纠结的函数代码 [打印本页]

---

作者: superwujc    时间: 2012-12-18 17:55
标题: 求教一段纠结的函数代码


下列代码有些又臭又长，摘自《The Linux Programming Interface》第4章，Page84，文件名为seek_io.c；我把它拼凑到了一起，没办法，小弟水平太菜，不知道怎样发问

先说一下代码功能：验证Linux系统调用open()，read()，write()和lseek()，第一个命令行参数指定将要被打开的文件，其余的参数指定将要在文件上执行的IO操作，每个操作包含一个  字母+数值  的形式
s表示偏移量，r表示从当前偏移量读取并以文本形式打印，R表示从当前偏移量读取并以十六进制形式打印，这3个参数都后跟表示字节长度的数值，w表示写入字符，后跟指定的字符串

如，seek_io myfile wxyz s1 r2   表示打开（或新建）myfile文件，在当前偏移量写入字符xyz，从文件开始处设置1字节的偏移量后，读取2个字节

由于里面细节有些复杂，说一下具体疑问：
在main()中执行到if (-1 == fd)判断文件是否打开或创建成功时，调用了errExit()函数，而errExit()函数又调用了outputError()函数，但是想不通这个outputError()函数是干什么用的，为什么直接调用先前定义的Boolean类型，而且是直接使用TRUE
烦请哪位大神，帮忙解释一下if (-1 == fd)时，调用errExit()函数和outputError()函数处理的具体思路和具体步骤吗？不胜感激！！！


头文件和函数声明部分

1. #include <stdio.h>
   
2. #include <sys/types.h>
   
3. #include <sys/stat.h>
   
4. #include <fcntl.h>
   
5. #include <unistd.h>
   
6. #include <string.h>
   
7. #include <stdlib.h>
   
8. #include <errno.h>
   
9. #include <stdarg.h>
   
10. #include "ename.c.inc"
    
11. #include <ctype.h>    //declaration for character test & map function
    
12. 
    
13. #define GN_NONNEG       01      /* Value must be >= 0 */
    
14. #define GN_GT_0         02      /* Value must be > 0 */
    
15. 
    
16. #define GN_ANY_BASE   0100      /* Can use any base - like strtol(3) */
    
17. #define GN_BASE_8     0200      /* Value is expressed in octal */
    
18. #define GN_BASE_16    0400      /* Value is expressed in hexadecimal */
    
19. 
    
20. typedef enum { FALSE, TRUE } Boolean;
    
21. 
    
22. void usageErr(const char *format, ...);
    
23. void errExit(const char *format, ...);
    
24. void cmdLineErr(const char *format, ...);
    
25. static void terminate(Boolean useExit3);
    
26. static void outputError(Boolean useErr, int err, Boolean flushStdout,
    
27.         const char *format, va_list ap);
    
28. 
    
29. static void gnFail(const char *fname, const char *msg, const char *arg, const char *name);
    
30. long getLong(const char *arg, int flags, const char *name);
    
31. static long getNum(const char *fname, const char *arg, int flags, const char *name);

复制代码

ename.c.inc部分

1. static char *ename[] = {
   
2.     /*   0 */ "",
   
3.     /*   1 */ "EPERM", "ENOENT", "ESRCH", "EINTR", "EIO", "ENXIO",
   
4.     /*   7 */ "E2BIG", "ENOEXEC", "EBADF", "ECHILD",
   
5.     /*  11 */ "EAGAIN/EWOULDBLOCK", "ENOMEM", "EACCES", "EFAULT",
   
6.     /*  15 */ "ENOTBLK", "EBUSY", "EEXIST", "EXDEV", "ENODEV",
   
7.     /*  20 */ "ENOTDIR", "EISDIR", "EINVAL", "ENFILE", "EMFILE",
   
8.     /*  25 */ "ENOTTY", "ETXTBSY", "EFBIG", "ENOSPC", "ESPIPE",
   
9.     /*  30 */ "EROFS", "EMLINK", "EPIPE", "EDOM", "ERANGE",
   
10.     /*  35 */ "EDEADLK/EDEADLOCK", "ENAMETOOLONG", "ENOLCK", "ENOSYS",
    
11.     /*  39 */ "ENOTEMPTY", "ELOOP", "", "ENOMSG", "EIDRM", "ECHRNG",
    
12.     /*  45 */ "EL2NSYNC", "EL3HLT", "EL3RST", "ELNRNG", "EUNATCH",
    
13.     /*  50 */ "ENOCSI", "EL2HLT", "EBADE", "EBADR", "EXFULL", "ENOANO",
    
14.     /*  56 */ "EBADRQC", "EBADSLT", "", "EBFONT", "ENOSTR", "ENODATA",
    
15.     /*  62 */ "ETIME", "ENOSR", "ENONET", "ENOPKG", "EREMOTE",
    
16.     /*  67 */ "ENOLINK", "EADV", "ESRMNT", "ECOMM", "EPROTO",
    
17.     /*  72 */ "EMULTIHOP", "EDOTDOT", "EBADMSG", "EOVERFLOW",
    
18.     /*  76 */ "ENOTUNIQ", "EBADFD", "EREMCHG", "ELIBACC", "ELIBBAD",
    
19.     /*  81 */ "ELIBSCN", "ELIBMAX", "ELIBEXEC", "EILSEQ", "ERESTART",
    
20.     /*  86 */ "ESTRPIPE", "EUSERS", "ENOTSOCK", "EDESTADDRREQ",
    
21.     /*  90 */ "EMSGSIZE", "EPROTOTYPE", "ENOPROTOOPT",
    
22.     /*  93 */ "EPROTONOSUPPORT", "ESOCKTNOSUPPORT",
    
23.     /*  95 */ "EOPNOTSUPP/ENOTSUP", "EPFNOSUPPORT", "EAFNOSUPPORT",
    
24.     /*  98 */ "EADDRINUSE", "EADDRNOTAVAIL", "ENETDOWN", "ENETUNREACH",
    
25.     /* 102 */ "ENETRESET", "ECONNABORTED", "ECONNRESET", "ENOBUFS",
    
26.     /* 106 */ "EISCONN", "ENOTCONN", "ESHUTDOWN", "ETOOMANYREFS",
    
27.     /* 110 */ "ETIMEDOUT", "ECONNREFUSED", "EHOSTDOWN", "EHOSTUNREACH",
    
28.     /* 114 */ "EALREADY", "EINPROGRESS", "ESTALE", "EUCLEAN",
    
29.     /* 118 */ "ENOTNAM", "ENAVAIL", "EISNAM", "EREMOTEIO", "EDQUOT",
    
30.     /* 123 */ "ENOMEDIUM", "EMEDIUMTYPE", "ECANCELED", "ENOKEY",
    
31.     /* 127 */ "EKEYEXPIRED", "EKEYREVOKED", "EKEYREJECTED",
    
32.     /* 130 */ "EOWNERDEAD", "ENOTRECOVERABLE", "ERFKILL"
    
33. };
    
34. 
    
35. #define MAX_ENAME 132

复制代码

main部分

1. int main (int argc, char *argv[])
   
2. {
   
3.         size_t len;
   
4.         off_t offset;
   
5.         int fd, ap, j;
   
6.         char *buf;
   
7.         ssize_t numRead, numWritten;
   
8. 
   
9.         if (argc < 3 || 0 == strcmp(argv[1], "--help"))
   
10.         {
    
11.                 usageErr ("%s file {r<length>|R<length>|w<string>|s<offset>}...\n", argv[0]);//only two arguments
    
12.         }
    
13. 
    
14.         fd = open (argv[1], O_RDWR | O_CREAT,
    
15.                                 S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH);//rw-rw-rw
    
16.        
    
17.         if (-1 == fd)
    
18.         {
    
19.                 errExit ("open");
    
20.         }
    
21.        
    
22.         for (ap = 2; ap  < argc; ap++)
    
23.         {
    
24.                 switch (argv[ap][0])
    
25.                 {
    
26.                         case 'r':
    
27.                         case 'R':
    
28.                                 len = getLong (&argv[ap][1], GN_ANY_BASE, argv[ap]);
    
29. 
    
30.                                 buf = malloc (len);
    
31.                                 if (NULL == buf)
    
32.                                 {
    
33.                                         errExit ("malloc");
    
34.                                 }
    
35. 
    
36.                                 numRead = read (fd, buf, len);
    
37.                                 if (-1 == numRead)
    
38.                                 {
    
39.                                         errExit ("read");
    
40.                                 }
    
41. 
    
42.                                 if (0 == numRead)
    
43.                                 {
    
44.                                         printf ("%s: end-of-file\n", argv[ap]);
    
45.                                 } else
    
46.                                 {
    
47.                                         printf ("%s: ", argv[ap]);
    
48.                                         for (j = 0; j < numRead; j++)
    
49.                                         {
    
50.                                                 if ('r' == argv[ap][0])
    
51.                                                 {
    
52.                                                         printf ("%c", isprint((unsigned char) buf[j]) ?
    
53.                                                                                                         buf[j] : '?');
    
54.                                                 } else
    
55.                                                 {
    
56.                                                         printf ("%02x ", (unsigned int) buf[j]);
    
57.                                                 }
    
58.                                         }
    
59.                                         printf ("\n");
    
60.                                 }
    
61. 
    
62.                                 free (buf);
    
63.                                 break;
    
64.                         case 'w':
    
65.                                 numWritten  = write (fd, &argv[ap][1], strlen (&argv[ap][1]));
    
66.                                 if (-1 == numWritten)
    
67.                                 {
    
68.                                         errExit ("write");
    
69.                                 }
    
70.                                 printf ("%s: wrote %ld bytes\n", argv[ap], (long) numWritten);
    
71.                                 break;
    
72.                         case 's':
    
73.                                 offset = getLong (&argv[ap][1], GN_ANY_BASE, argv[ap]);
    
74.                                 if (-1 == lseek (fd, offset, SEEK_SET))
    
75.                                 {
    
76.                                         errExit ("lseek");
    
77.                                 }
    
78.                                 printf ("%s: seek succeeded\n", argv[ap]);
    
79.                                 break;
    
80.                         default:
    
81.                                 cmdLineErr ("Argument must start with [rRws]: %s\n", argv[ap]);
    
82.                 }
    
83.         }
    
84.         exit (EXIT_SUCCESS);
    
85. }

复制代码

其他函数部分

1. void usageErr(const char *format, ...)
   
2. {
   
3.     va_list argList;
   
4. 
   
5.     fflush(stdout);           /* Flush any pending stdout */
   
6. 
   
7.     fprintf(stderr, "Usage: ");
   
8.     va_start(argList, format);
   
9.     vfprintf(stderr, format, argList);
   
10.     va_end(argList);
    
11. 
    
12.     fflush(stderr);           /* In case stderr is not line-buffered */
    
13.     exit(EXIT_FAILURE);
    
14. }
    
15. 
    
16. void errExit(const char *format, ...)
    
17. {
    
18.     va_list argList;
    
19. 
    
20.     va_start(argList, format);
    
21.     outputError(TRUE, errno, TRUE, format, argList);
    
22.     va_end(argList);
    
23. 
    
24.     terminate(TRUE);
    
25. }
    
26. 
    
27. 
    
28. void terminate(Boolean useExit3)
    
29. {
    
30.     char *s;
    
31. 
    
32.     /* Dump core if EF_DUMPCORE environment variable is defined and
    
33.        is a nonempty string; otherwise call exit(3) or _exit(2),
    
34.        depending on the value of 'useExit3'. */
    
35. 
    
36.     s = getenv("EF_DUMPCORE");
    
37. 
    
38.     if (s != NULL && *s != '\0')
    
39.         abort();
    
40.     else if (useExit3)
    
41.         exit(EXIT_FAILURE);
    
42.     else
    
43.         _exit(EXIT_FAILURE);
    
44. }
    
45. 
    
46. void cmdLineErr(const char *format, ...)
    
47. {
    
48.     va_list argList;
    
49. 
    
50.     fflush(stdout);           /* Flush any pending stdout */
    
51. 
    
52.     fprintf(stderr, "Command-line usage error: ");
    
53.     va_start(argList, format);
    
54.     vfprintf(stderr, format, argList);
    
55.     va_end(argList);
    
56. 
    
57.     fflush(stderr);           /* In case stderr is not line-buffered */
    
58.     exit(EXIT_FAILURE);
    
59. }
    
60. 
    
61. long getNum(const char *fname, const char *arg, int flags, const char *name)
    
62. {
    
63.     long res;
    
64.     char *endptr;
    
65.     int base;
    
66. 
    
67.     if (arg == NULL || *arg == '\0')
    
68.         gnFail(fname, "null or empty string", arg, name);
    
69. 
    
70.     base = (flags & GN_ANY_BASE) ? 0 : (flags & GN_BASE_8) ? 8 :
    
71.                         (flags & GN_BASE_16) ? 16 : 10;
    
72. 
    
73.     errno = 0;
    
74.     res = strtol(arg, &endptr, base);
    
75.     if (errno != 0)
    
76.         gnFail(fname, "strtol() failed", arg, name);
    
77. 
    
78.     if (*endptr != '\0')
    
79.         gnFail(fname, "nonnumeric characters", arg, name);
    
80. 
    
81.     if ((flags & GN_NONNEG) && res < 0)
    
82.         gnFail(fname, "negative value not allowed", arg, name);
    
83. 
    
84.     if ((flags & GN_GT_0) && res <= 0)
    
85.         gnFail(fname, "value must be > 0", arg, name);
    
86. 
    
87.     return res;
    
88. }
    
89. 
    
90. void gnFail(const char *fname, const char *msg, const char *arg, const char *name)
    
91. {
    
92.     fprintf(stderr, "%s error", fname);
    
93.     if (name != NULL)
    
94.         fprintf(stderr, " (in %s)", name);
    
95.     fprintf(stderr, ": %s\n", msg);
    
96.     if (arg != NULL && *arg != '\0')
    
97.         fprintf(stderr, "        offending text: %s\n", arg);
    
98. 
    
99.     exit(EXIT_FAILURE);
    
100. }
     
101. 
     
102. void outputError(Boolean useErr, int err, Boolean flushStdout,
     
103.         const char *format, va_list ap)
     
104. {
     
105. #define BUF_SIZE 500
     
106.     char buf[BUF_SIZE], userMsg[BUF_SIZE], errText[BUF_SIZE];
     
107. 
     
108.     vsnprintf(userMsg, BUF_SIZE, format, ap);
     
109. 
     
110.     if (useErr)
     
111.         snprintf(errText, BUF_SIZE, " [%s %s]",
     
112.                 (err > 0 && err <= MAX_ENAME) ?
     
113.                 ename[err] : "?UNKNOWN?", strerror(err));
     
114.     else
     
115.         snprintf(errText, BUF_SIZE, ":");
     
116. 
     
117.     snprintf(buf, BUF_SIZE, "ERROR%s %s\n", errText, userMsg);
     
118. 
     
119.     if (flushStdout)
     
120.         fflush(stdout);       /* Flush any pending stdout */
     
121.     fputs(buf, stderr);
     
122.     fflush(stderr);           /* In case stderr is not line-buffered */
     
123. }
     
124. 
     
125. long getLong(const char *arg, int flags, const char *name)
     
126. {
     
127.     return getNum("getLong", arg, flags, name);
     
128. }

复制代码

---

作者: sqfasd    时间: 2012-12-18 18:30
userMsg，是你调用errExit穿进去的字符串
errText是是标准库内部产生的错误，通过strerror(err)获取，err是标准库定义的全局变量errno传过来的，useErr用来标识是否打印这个错误
最后把这两个错误信息合并打印

有点不太理解这段
if (flushStdout)
        fflush(stdout);       /* Flush any pending stdout */
下面反正是要fflush的，为什么还要多调用一次fflush，这是出于什么考虑，有人能解答一下吗？

---

作者: crazy_snail    时间: 2012-12-18 20:19
useErr 设置为 TRUE 的话， 输出详细的错误信息—— 使用ename数组吧errno翻译为字符串，并用strerror获得原因。 然后再附加上userMsg， 否则的话只有userMsg。
这里作者直接用TRUE可能是想让errExit输出详细的错误信息。

最后fflush标准输出和标准错误输出

---

欢迎光临 Chinaunix (http://bbs.chinaunix.net/)

Powered by Discuz! X3.2