CVS log for src/share/man/man9/percpu.9

Up to [cvs.NetBSD.org] / src / share / man / man9

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

percpu(9): percpu_create ctor may be called later, not synchronously.

Merge changes from current as of 20200406

Remove duplicate word.

Document percpu_foreach_xcall().

New function percpu_create.

Associates a constructor and destructor with the percpu.  Currently
the constructor runs immediately, but in principle we could use the
same API for future CPU hotplug support.

This lets you sleep for allocation or draining users before
deallocation when setting up or tearing down a percpu -- currently we
have many abuses of percpu_foreach in tree for that purpose.

Proposed on tech-kern:
https://mail-index.NetBSD.org/tech-kern/2020/01/30/msg026036.html

vmem_alloc() with VM_SLEEP cannot fail, so percpu_alloc() cannot fail either.

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

Merge riastradh-drm2 to HEAD.

sync with HEAD

Use Mt for email addresses.

Remove boilerplate in CODE REFERENCES on file paths.
Describe in intro(9) how to read paths in the CODE REFERENCES section.

Remove trailing whitespace, fix xref to xcall.

Cross-link a little.

Remove xc_init_cpu(), percpu_init(), percpu_init_cpu() - they are part
of implementation, not public API.  OK dyoung@.

Cross-reference xc(9) instead of queue(9).

Add missing .El.

Move a start of sentence to the first column.

Mention all of the API routines in the NAME section, and capitalize
'percpu'.  Also in the NAME section, call it a "Per-CPU storage
allocator."

Add a manual page for per-CPU storage.  Somebody should read this to
make sure I've described it correctly and intelligibly.

TBD: hook this up in the Makefile and in the set lists.