Avoid using register_t or vsize_t in <puffs.h>

<puffs.h> is a user-space header, and should not use any of
kernel-only types. It's not reasonable to require user-land
filesystems to #define _KERNTYPES.

fix typos in puffs man pages.

Remove workaround for ancient HTML generation code.

mention puffs_node_pathconf and puffs_node_advlock

consistency fixes.

fix return type

filesystem -> file system

Bump date for previous. Remove trailing space.

libpuffs support for fallocate and fdiscard operations

src is too big these days to tolerate superfluous apostrophes. It's
"its", people!

Bump date for previous.

Add an open2 method, like open but with an additionnal oflags used
by the filesystem to send back information about the file.
This is used to implement PUFFS_OPEN_IO_DIRECT by which the filesystem
tells the kernel that read/write should bypass the page cache.

branches: 1.36.10;
Whitespace fixes. Bump date for previous.

Fix regression that has been introduced when the lookup/reclaim race
condition was addressed in libpuffs by counting lookups.

The fix assumes that cookies map to struct puffs_cookie, which has not
been documented as a requirement for filesystems using libpuffs. As an
example, we got burnt by this assumption in libp2k (kern/46734), and
we fixed bit by actually mapping libp2k cookies to struct puffs_node.

It is unlikely, but there may be third party filesystems that use cookies
unmapped to struct puffs_node, and they were left broken for now.

- we introduce a puffs_init() flag PUFFS_FLAG_PNCOOKIE that let filesystems
inform libpuffs that they map cookies to struct puffs_node. Is that flag
is used, the lookup/reclaim race condition fix is enabled. We enable the
flag for libp2k.

- filesystems that use puffs_pn_new() obviouslty use struct puffs_node
and gain PUFFS_FLAG_PNCOOKIE automatically even if they did not specify
it in puffs_init(). This include all our PUFFS filesystem in-tree except
libp2k.

- for filesystems not willing to use struct puffs_node, we introduce a
reclaim2 vnop, which is reclaim with an additionnal lookup count argument.
This vnop let the filesystem implement the lookup/reclaim race fix on
its own.

Kill extra Fc macro.

Bump date for previous, remove trailing whitespace.

Pass the FAF flag to handlers:
- setattr_ttl is updated to add a flag argument. Since it was not present in
a previous release, we can change its API
- write2 is introduced, this is write with an extra flag for FAF.
- fsync already has the FAF information in a flag and needs no change
- for other operations, FAF is unconditional

Bump date for previous.
New sentence, new line; remove trailing whitespace; fix typos;
punctuation nits.

- When using PUFFS_KFLAG_CACHE_FS_TTL, do not use puffs_node to carry
attribute and TTL fora newly created node. Instead extend puffs_newinfo
and add puffs_newinfo_setva() and puffs_newinfo_setttl()
- Remove node_mk_common_final in libperfuse. It used to set uid/gid for
a newly created vnode but has been made redundant along time ago since
uid and gid are properly set in FUSE header.
- In libperfuse, check for corner case where opc = 0 on INACTIVE and RECLAIM (how is it possible? Check for it to avoid a crash anyway)
- In libperfuse, make sure we unlimit RLIMIT_AS and RLIMIT_DATA so that
we do notrun out of memory because the kernel is lazy at reclaiming vnodes.
- In libperfuse, cleanup style of perfuse_destroy_pn()

branches: 1.29.2; 1.29.4;
Add a flag to VOP_LISTEXTATTR(9) so that the vnode interface can tell the
filesystem in which format extended attribute shall be listed.

There are currently two formats:
- NUL-terminated strings, used for listxattr(2), this is the default.
- one byte length-pprefixed, non NUL-terminated strings, used for
extattr_list_file(2), which is obtanined by setting the
EXTATTR_LIST_PREFIXLEN flag to VOP_LISTEXTATTR(9)

This approach avoid the need for converting the list back and forth, except
in libperfuse, since FUSE uses NUL-terminated strings, and the kernel may
have requested EXTATTR_LIST_PREFIXLEN.

In node_lookup() ops, pcn->pcn_nameiop contains a NAMEI_* constant, not
PUFFSLOOKUP_*

document abortop. part of PR kern/44208

mention extended attribute ops

New sentence, new line.

Fix markup.

Remove the paragraph saying interfaces will change without warning.
Note that a stable version of puffs first appeared in NetBSD 5.0.

branches: 1.22.2;
i'm almost certain that puffs_cooie_t is supposed to be puffs_cookie_t

branches: 1.21.4;
Replace void * by puffs_cookie_t where appropriate. No functional change.

branches: 1.20.6;
Clarify that link_target in node_symlink is null-terminated.

Add comma in enumeration.

Fix a typo that has migrated across files.

Rototill.

Ok, ok, a few more words about it: stop holding puffs_cc as a holy
value and passing it around to almost every possible place (popquiz:
which kernel variable does this remind you of?). Instead, pass
the natural choice, puffs_usermount, and fetch puffs_cc via
puffs_cc_getcc() only in routines which actually need it. This
not only simplifies code, but (thanks to the introduction of
puffs_cc_getcc()) enables constructs which weren't previously sanely
possible, say layering as a curious example.

There's still a little to do on this front, but this was the major
fs interface blast.

Remove "puffs_cid" from the puffs interface following l-removal
from the kernel vfs interfaces. puffs_cc_getcaller(pcc) can be
used now should the same information be desired.

branches: 1.15.2; 1.15.4;
Per rumble's lead in vnodeops, clarify the bit about readdir cookies.

* add missing credential handle to fsync args
* and now with more cosmetic attack

pure cosmetics: minor facelift

note caveat with puffs_node_poll

Use HTML escapes. Drop trailing whitespace. Punctuation nits.

wizd reminded me that if I provide the synopsis for puffs_node_seek(),
I would do well to also describe what it does. so make it so.

uncomment puffs_node_seek - it's supported and in use

puffs_cid* is always const

apply ketchup to recent source changes in libpuffs

document puffs_node_poll

document puffs_setback()

fix readdir prototype

* describe fhtonode, nodetofh and suspend
* update description of readdir to match reality

improve markup and descriptions

Move file system and node callbacks into their own manual page.
Improve markup and descriptions a bit (not completely finished yet).