ne_status.3 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  1. '\" t
  2. .\" Title: ne_status
  3. .\" Author:
  4. .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
  5. .\" Date: 20 September 2021
  6. .\" Manual: neon API reference
  7. .\" Source: neon 0.32.1
  8. .\" Language: English
  9. .\"
  10. .TH "NE_STATUS" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
  11. .\" -----------------------------------------------------------------
  12. .\" * Define some portability stuff
  13. .\" -----------------------------------------------------------------
  14. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15. .\" http://bugs.debian.org/507673
  16. .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18. .ie \n(.g .ds Aq \(aq
  19. .el .ds Aq '
  20. .\" -----------------------------------------------------------------
  21. .\" * set default formatting
  22. .\" -----------------------------------------------------------------
  23. .\" disable hyphenation
  24. .nh
  25. .\" disable justification (adjust text to left margin only)
  26. .ad l
  27. .\" -----------------------------------------------------------------
  28. .\" * MAIN CONTENT STARTS HERE *
  29. .\" -----------------------------------------------------------------
  30. .SH "NAME"
  31. ne_status \- HTTP status structure
  32. .SH "SYNOPSIS"
  33. .sp
  34. .ft B
  35. .nf
  36. #include <ne_utils\&.h>
  37. typedef struct {
  38. int major_version, minor_version;
  39. int code, klass;
  40. const char *reason_phrase;
  41. } ne_status;
  42. .fi
  43. .ft
  44. .SH "DESCRIPTION"
  45. .PP
  46. An
  47. \fBne_status\fR
  48. type represents an HTTP response status; used in response messages giving a result of request\&. The
  49. \fImajor_version\fR
  50. and
  51. \fIminor_version\fR
  52. fields give the HTTP version supported by the server issuing the response\&. The
  53. \fIcode\fR
  54. field gives the status code of the result (lying between 100 and 999 inclusive), and the
  55. \fIklass\fR
  56. field gives the class\&\s-2\u[1]\d\s+2, which is equal to the most significant digit of the status\&.
  57. .PP
  58. There are five classes of HTTP status code defined by RFC2616:
  59. .PP
  60. 1xx
  61. .RS 4
  62. Informational response\&.
  63. .RE
  64. .PP
  65. 2xx
  66. .RS 4
  67. Success: the operation was successful
  68. .RE
  69. .PP
  70. 3xx
  71. .RS 4
  72. Redirection
  73. .RE
  74. .PP
  75. 4xx
  76. .RS 4
  77. Client error: the request made was incorrect in some manner\&.
  78. .RE
  79. .PP
  80. 5xx
  81. .RS 4
  82. Server error
  83. .RE
  84. .SH "SEE ALSO"
  85. .PP
  86. ne_get_status\&.
  87. .SH "AUTHOR"
  88. .PP
  89. \fBJoe Orton\fR <\&[email protected]\&>
  90. .RS 4
  91. Author.
  92. .RE
  93. .SH "COPYRIGHT"
  94. .br
  95. .SH "NOTES"
  96. .IP " 1." 4
  97. the field is named
  98. \(lqklass\(rq
  99. not
  100. \(lqclass\(rq
  101. so that the header can be used from a C++ program, in which
  102. \(lqclass\(rq
  103. is a reserved word)