Bug 192267
| Summary: | queue(3) doesn't note that HEADNAME argument in *_HEAD macro is optional/creates anonymous structs | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Documentation | Reporter: | Enji Cooper <ngie> | ||||
| Component: | Manual Pages | Assignee: | freebsd-bugs (Nobody) <bugs> | ||||
| Status: | Open --- | ||||||
| Severity: | Affects Some People | CC: | doc, felix.the.red | ||||
| Priority: | --- | Keywords: | patch | ||||
| Version: | Latest | ||||||
| Hardware: | Any | ||||||
| OS: | Any | ||||||
| Attachments: |
|
||||||
Created attachment 228599 [details] queue(3) patch Convert macro definitions to subsection. Document that if HEADNAME is omitted, the resulting structure will be anonymous. Change np_temp function argument to tvar to match macro implementation (bug #192266). |
Some of the code in the tree uses the data structures in a one-off manner, such that specifying the HEADNAME value for the *_HEAD macro isn't required. What omitting HEADNAME does is creates an anonymous structure for describing the data structure/pointers, whereas specifying HEADNAME creates a named structure for describing the data structure/pointers, i.e. 149 #define SLIST_HEAD(name, type) \ 150 struct name { \ 151 struct type *slh_first; /* first element */ \ 152 } ... 242 #define STAILQ_HEAD(name, type) \ 243 struct name { \ 244 struct type *stqh_first;/* first element */ \ 245 struct type **stqh_last;/* addr of last next element */ \ 246 } ... 363 #define LIST_HEAD(name, type) \ 364 struct name { \ 365 struct type *lh_first; /* first element */ \ 366 } ... 491 #define TAILQ_HEAD(name, type) \ 492 struct name { \ 493 struct type *tqh_first; /* first element */ \ 494 struct type **tqh_last; /* addr of last next element */ \ 495 TRACEBUF \ 496 }