NetBSD-Bugs archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

re: kern/37427 document _ksem_* syscalls

The following reply was made to PR kern/37427; it has been noted by GNATS.

From: Paul Goyette <>
To: matthew green <>
Subject: re: kern/37427 document _ksem_* syscalls
Date: Sun, 29 Nov 2015 06:29:10 +0800 (PHT)

 On Sun, 29 Nov 2015, matthew green wrote:
 >>  We currently have man pages for sem(4) with cross-refs to several other
 >>  pages for the specific functions.
 >>  Is there any reason why this is insufficient?  If this is OK, I will
 >>  close the PR.
 > is there documentation on the backend that is sufficient?  how is
 > someone supposed to look at the sem(4) code without understanding
 > the system calls that back it?
 > i don't agree that "hidden" functionality should not be documented,
 > and for actual system calls i don't believe that "in the sources"
 > suffices.
 Ah, so in addition to wanting the syscalls themselves documented
 (which we have already), you want to see a ksem(9) man page 
 describing the internal workings?
 Let me see if I can do something here...  Step 1 - study code ...
 | Paul Goyette     | PGP Key fingerprint:     | E-mail addresses:       |
 | (Retired)        | FA29 0E3B 35AF E8AE 6651 | paul at    |
 | Kernel Developer | 0786 F758 55DE 53BA 7731 | pgoyette at  |

Home | Main Index | Thread Index | Old Index