Commit Graph

1592 Commits

Author SHA1 Message Date
kamil 2e2dd171b3 Correct man-page category of posix_spawn: is (3) not (2) 2017-01-11 07:32:36 +00:00
kamil 5ed9a833b2 Document SIGTRAP with si_code TRAP_CHLD in ptrace(2)
Document the current behavior of TRAP_CHILD in NetBSD.
Add more notes on PTRACE_FORK events.

Sponsored by <The NetBSD Foundation>
2017-01-11 07:31:14 +00:00
abhinav fe8fae7920 Add missing word. 2017-01-10 06:28:46 +00:00
kamil 69c3a1c44c Add more notes explaining how debuggers work on NetBSD
Explain:
 - execve(2) handling and behavior, SIGTRAP & TRAP_EXEC
 - reference PaX MPROTECT restrictions for debuggers
 - software breakpoints handling and behavior, SIGTRAP & TRAP_BKPT
 - single step behavior, SIGTRAP & TRAP_TRACE
 - list predefined MI symbols for help debuggers in port specific headers
 - explain that PT_TRACE_ME does not send a SIGSTOP signal

Sponsored by <The NetBSD Foundation>
2017-01-07 05:51:14 +00:00
kamil 6a0def7293 Document PT_SET_SIGINFO and PT_GET_SIGINFO in ptrace(2)
PT_SET_SIGINFO - fake signal information emitted to tracee
PT_GET_SIGINFO - read signal information routed to tracee

Sponsored by <The NetBSD Foundation>
2017-01-07 03:41:25 +00:00
kamil 6615db4a39 Fix swapped text between PT_GET_PROCESS_STATE and PT_GET_EVENT_MASK
Sponsored by <The NetBSD Foundation>
2017-01-07 01:32:35 +00:00
kamil 929c1cc1fe ptrace(2): Document addr and data argument usage for PT_GET_PROCESS_STATE
The PT_GET_PROCESS_STATE call in ptrace(2) has the following usage of addr
and data:

    A pointer to this structure is passed in addr.  The data
    argument should be set to sizeof(struct ptrace_event).

Sponsored by <The NetBSD Foundation>
2017-01-07 01:29:18 +00:00
kamil 383dde7b6a Reference siginfo(2) for a SIGCHLD signal
siginfo(2) describes appropriate signal specific information for SIGCHLD.

Sponsored by <The NetBSD Foundation>
2016-12-29 22:17:51 +00:00
abhinav af4d0016d3 Use markup for errno
Also remove a .Pp before .Bl while there
2016-12-19 07:48:35 +00:00
abhinav fc41d23c04 Be consistent in using process' (vs process's). 2016-12-19 07:17:45 +00:00
abhinav 490a78e58c Fix sentence. 2016-12-19 06:45:29 +00:00
kamil 1779f12820 ptrace(2): Document PT_GETVECREGS and PT_SETVECREGS (ppc ports specific)
Sponsored by <The NetBSD Foundation>
2016-12-15 15:03:17 +00:00
kamil 3c3d6699d5 ptrace(2): Document PT_GETXMMREGS and PT_SETXMMREGS (i386 port specific)
Sponsored by <The NetBSD Foundation>
2016-12-15 14:49:46 +00:00
kamil 091cebb2c4 ptrace(2): Remove dead text, some of it commented in this file for years
For example PT_READ_U/PT_WRITE_U has been removed by <mycroft> in 19950126.

Sponsored by <The NetBSD Foundation>
2016-12-15 13:06:08 +00:00
kamil 4067ec816b Remove outdated note in the PT_DUMPCORE call of the ptrace(2) man-page
Currently the PT_DUMPCORE call requires process to be stopped, therefore it
no longer need to warn about stoped tracee to generate consistent data.

Sponsored by <The NetBSD Foundation>
2016-12-10 20:02:07 +00:00
kamil eedb67d83d Remove duplicated PT_DUMPCORE description in machine-specific calls section
This function is part of the general ptrace(2) interface.

Sponsored by <The NetBSD Foundation>
2016-11-24 00:12:52 +00:00
wiz 14feb52a56 Whitespace. 2016-11-20 09:38:37 +00:00
dholland b6a15c213c Add crossreference to fork(2) per note in PR 9627. 2016-11-20 07:05:20 +00:00
wiz f662fdae7e Whitespace. 2016-11-14 10:40:59 +00:00
christos c231d3fa1b Explain rmtp setting. 2016-11-11 16:07:05 +00:00
christos 50d1e6ecfe Document WNOZOMBIE 2016-11-10 17:08:31 +00:00
pgoyette bf821edee1 Typo - "a requests" --> "a request" 2016-11-02 03:21:38 +00:00
wiz f899b3dcea Bump date for previous. 2016-11-01 15:30:47 +00:00
kamil 0144090d24 Document PT_SET_EVENT_MASK, PT_GET_EVENT_MASK and PT_GET_PROCESS_STATE
These descriptions are imported from OpenBSD.

Approved by <christos>

Sponsored by <The NetBSD Foundation>
2016-11-01 13:51:13 +00:00
wiz d6414e373d Remove duplicate Pp. 2016-09-27 11:11:43 +00:00
christos a49c1d21d7 move the description of CLOCK_REALTIME in the list. 2016-09-24 01:05:51 +00:00
wiz 0c9a844188 Merge ENOMEM descriptions. 2016-08-28 05:07:50 +00:00
dholland 880009a06c fix broken xrefs 2016-08-28 00:15:01 +00:00
dholland c959793a57 Rework pursuant to PR 7934: be more clear about the page granularity
behavior and when new memory is zeroed.

Also, strengthen the warning about mixing with calls to malloc (which
is not a bug) and mention that the portable way to fetch the initial
break is to call sbrk(0). There are implementations in the wild where
using _end as the initial break doesn't work.
2016-08-27 23:06:01 +00:00
wiz 6333fb3d2f Sort errors. 2016-07-30 11:31:00 +00:00
njoly c38e2c9645 Remove obsolete BUGS section. getsockname(2) report sensible values
for bound UNIX domain sockets.
2016-07-30 11:10:40 +00:00
wiz 8cc73798f2 Remove one of the two SEE ALSO sections. 2016-07-25 22:00:36 +00:00
wiz 7304bf1e95 Merge two EAGAIN sections. 2016-07-12 12:24:40 +00:00
dholland 20b32a3eee Drop in a reference to the list of async-signal-safe functions. 2016-07-09 23:10:05 +00:00
dholland b00b33da18 Dump the list of async-signal-safe functions here. It belongs in
programmer-facing docs, not user-facing docs, so shouldn't be in
signal(7).
2016-07-09 23:08:32 +00:00
christos 7cf7644fc7 GSoC 2016 Charles Cui: Implement thread priority protection based on work
by Andy Doran. Also document the get/set pshared thread calls as not
implemented, and add a skeleton implementation that is disabled.
XXX: document _sched_protect(2).
2016-07-03 14:24:58 +00:00
wiz c763387bbc Bump date for header file change. 2016-06-30 18:43:43 +00:00
abhinav 5fd6a784bb Document WAIT_ANY and WAIT_MYPGRP constants
(text referenced from OpenBSD wait(2) man page)

While there, remove duplicated information and add more refernces in SEE ALSO
Also, the NOTES section refers to intro(2), while siginterrupt(3) is a better
suited reference, so fix that too.

Ok by wiz
2016-06-30 17:00:55 +00:00
dholland ae3b3bcc2b PR 51287 Ralf Nolden: posix_fallocate belongs in <fcntl.h> 2016-06-30 15:29:20 +00:00
kamil e3d1905862 Use generic types in the profil(2) function prototype (<unistd.h>) 2016-06-18 14:39:15 +00:00
ryoon 71d366f3be Bump date for previous 2016-06-16 12:48:09 +00:00
ryoon e9d3857230 Fix typo 2016-06-16 12:47:10 +00:00
christos 3694604d12 move section around. 2016-04-29 13:17:09 +00:00
wiz eb86c933a1 Sort a bit more. 2016-04-29 12:25:51 +00:00
christos 8eca53f5f0 - merge the options descriptions, sort them.
- fix wrusage name.
2016-04-28 16:07:26 +00:00
wiz 982b0c24c2 Fix typos, whitespace, formatting. 2016-04-24 08:59:30 +00:00
christos 817b192df2 add clock_getcpuclockid{2,} 2016-04-23 23:11:31 +00:00
wiz 54920d4dc7 Drop trailing whitespace. 2016-04-06 08:18:35 +00:00
christos 7ffce30f1b revert part of previous; not needed. 2016-04-06 04:09:10 +00:00
christos a071bd3ff9 - clarify si_signo difference for waitid and wait6 as per POSIX.
- implement it.
- document WIFCONTINUED
2016-04-06 03:50:03 +00:00
wiz 386cb828c3 Use more markup, fix a typo. 2016-04-04 13:13:09 +00:00
christos aad157eb21 add idtype.h to mklintstub and say who generates it. 2016-04-03 00:48:29 +00:00
christos 406ebcd6ac userland bits for wait6/waitid. 2016-04-03 00:19:42 +00:00
wiz 1b0989ebef Sort errors. Improve markup. 2016-03-20 20:09:49 +00:00
dholland 71d3320a40 Sync documentation of struct ktr_header with reality:
- there is a ktr_version field
   - the ordering of ktr_type and ktr_version is byte-order dependent
   - ktr_time is now a timespec, not a timeval
   - there's now a ktr_lid field
   - there is no such thing as a ktr_buf field and it's certainly not
     a caddr_t.

XXX: I would appreciate it if someone who knows how this stuff works
XXX: could review this file in case it's still lying in some more
XXX: subtle way.
2016-03-19 17:15:13 +00:00
dholland 02cda16070 Update documented prerequisite includes. PR 50633 and PR 50634.
Remove sys/uio.h, and swap sys/param.h for sys/types.h as sys/ktrace.h
depends on MAXCOMLEN.

Bump date; first time since 1993.
2016-03-19 17:05:36 +00:00
dholland 2a52e0ce6c MAXNAMLEN, not MAXNAMELEN. From Giuseppe Gatta on netbsd-docs. 2016-01-23 08:17:18 +00:00
wiz b02bef0817 Fix xrefs. 2015-12-30 16:51:31 +00:00
plunky ea8091c08e point to more information about clock_id 2015-12-30 16:47:24 +00:00
wiz d7f847e7d4 Fix date. 2015-12-09 08:30:03 +00:00
christos a25476cdad PR/50506: Tobias Nygren: kqueue(2) lacks EV_DISPATCH/EV_RECEIPT support 2015-12-08 14:52:06 +00:00
pgoyette c423c59d2d Update to match reality. For these functions, we still try the system
call first, and only fall back to /dev/clockctl if the system call
fails.
2015-12-07 23:20:57 +00:00
wiz 374d132d42 Drop trailing whitespace. 2015-11-29 21:38:10 +00:00
pgoyette 121d6f085a Initial documentation of the internal syscalls that implement the librt
posix semaphores.  As requested in PR kern/37427

XXX Feel free to expand this page!
2015-11-29 06:10:01 +00:00
pgoyette 82bcd0c81b Document the ms_flags field which is now exported in struct modstat 2015-11-04 04:31:53 +00:00
wiz c1ef8df3ab Fix macro. Remove trailing whitespace. 2015-11-01 08:52:29 +00:00
christos 94aa2c7cfc mention what we are allowed to do. 2015-10-31 17:45:32 +00:00
christos a786eb43af PR/50295: Fix clock_nanosleep return value documentation. 2015-10-02 19:52:49 +00:00
christos a42548a2aa document PIOD_READ_AUXV. 2015-07-02 03:50:21 +00:00
pgoyette 9fc9038db1 Provide additional info on why ENOEXEC gets returned. 2015-05-09 08:10:01 +00:00
wiz 858361fa34 Remove trailing whitespace. 2015-04-22 13:59:54 +00:00
christos 9cf433da08 Mention EWOULDBLOCK too since a lot of the source code and documentation still
refers to it.
2015-04-21 21:22:07 +00:00
wiz 1ce6069203 Sort errors. Bump date for previous. 2015-04-05 20:41:05 +00:00
rtr 2ed41a38ec Note that bind(2) can fail with EAFNOSUPPORT. The description of why is
taken from the connect(2) manpage.
2015-04-05 20:33:45 +00:00
christos 6998697823 say that we put the exit code in data. 2015-03-02 19:24:19 +00:00
christos f5804ec983 Document SIGBUS per ToG. 2015-02-27 16:18:00 +00:00
wiz b482bd6fc9 It is 2015 already. 2015-02-08 14:10:28 +00:00
njoly 45cb14b62a The length argument is of an unsigned type (size_t) and cannot be
negative. Remove wrong statements in ERRORS section.
2015-02-08 11:27:43 +00:00
christos 0bf39b3f13 PR/49617: Kirk Russell: Describe the posix_fallocate return values correctly. 2015-02-01 15:24:15 +00:00
christos 5415342756 PR/49617: Kirk Russell: posix_fallocate() should be returning an error on
failure, without setting errno, so make it PSEUDO_NOERROR, by adding a new
category GLUENOERR.
2015-01-31 23:10:56 +00:00
joerg 68179c3df2 Remove va_arg hack for Clang/PPC. 2015-01-29 20:44:38 +00:00
wiz 99c1481cc2 Remove superfluous comma. 2015-01-27 10:11:20 +00:00
pooka a17684a24c Add hooks for RUMPRUN build of libc
If "yes", does the following (default "no"):
  * prevents ASM syscalls from being built (librump provides syscalls)
  * does not include compat (useless when application is linked with libc)
  * does not build tags (no /var/db to install them to)
  * does not include tls

==> libc for rumprun can now be built against unmodified NetBSD sources
2014-12-10 00:37:30 +00:00
njoly 9425d53a52 Do not hardcode values for ENAMETOOLONG, use symblic constants. 2014-11-11 08:10:02 +00:00
njoly 294822e1e1 Use more markups in AUTHORS section. 2014-11-02 11:28:03 +00:00
njoly 0ab951a98a Note that rmdir(2) fails with EINVAL when the path last component is
`.' (dot).
2014-10-11 12:06:58 +00:00
njoly fd871e46ea Use '.Rv -std' for RETURN VALUES, sort ERRORS. 2014-10-11 11:50:11 +00:00
njoly 957f6a3676 Fix synopsis, remove unneeded Pp macro before display block and add one
before prototype. While here, use "Rv -std" for RETURN VALUES.
2014-09-27 12:11:13 +00:00
manu 724e214f8d Fix argument paddiing for posix_fallocate and fdiscard with gcc 1.x 2014-09-25 15:08:29 +00:00
wiz 2a65137f55 Sort sections. From Henning Petersen in PR 49222. 2014-09-19 16:02:58 +00:00
joerg 9074b7ff29 Use the lint path as workaround for Clang on 32bit PPC for now.
Document this hack.
2014-08-13 14:43:48 +00:00
joerg 76ef534724 If LINT code path uses memcpy, it should also include string.h. 2014-08-10 17:55:08 +00:00
riastradh 19aeab521f Rework minherit(2) man page into a table.
XXX Do we not guarantee page-granularity inheritance?  Cursory glance
at uvm suggests we do -- can we nix the caveats about regions vs
pages?
2014-08-05 15:01:03 +00:00
christos be225fdda5 PR/49045: Tetsuya Isaki: remove remaining caddr_t in ptrace(2) 2014-07-28 08:10:23 +00:00
wiz d882c3d502 Sort errors. Whitespace nits. 2014-07-25 08:47:42 +00:00
wiz 03f93851e3 Sort SEE ALSO. 2014-07-25 08:44:54 +00:00
dholland d0352e761c Add userlevel manifestations of posix_fallocate and fdiscard, in
unistd.h and libc, and add a man page.

Allow wiggle room in the man page for implementations of fallocate
that either (a) don't fully unwind on failure, leaving new blocks
allocated without changing the file size, or (b) create only in-memory
transient reservations that disappear when crashing or rebooting.

Also, add crossreference to fdiscard from ftruncate(2), and remove the
old BUGS entry from there that called for a generalized version that
allows discarding ranges of a file: that's what fdiscard is.
2014-07-25 08:30:47 +00:00
dholland 156ed6c7d3 fix usage 2014-07-19 19:26:47 +00:00
dholland 885875e18f Remove
Users should not depend on the memory sharing semantics of vfork() as
     other ways of speeding up the fork process may be developed in the
     future.

as we are not planning to deprecate vfork. Besides NetBSD's
compatibility policy means we wouldn't change it anyway but introduce
something new.

Add
     Portable applications should not depend on the memory sharing semantics
     of vfork() as implementations exist that implement vfork() as plain
     fork(2).

because this is or used to be a real hazard.

ok christos
2014-07-18 16:02:50 +00:00
dholland b50dcf12b2 Clarify HISTORY and bump date. 2014-07-18 15:58:51 +00:00