puffs_cc(3) [netbsd man page]

PUFFS_CC(3)						   BSD Library Functions Manual 					       PUFFS_CC(3)

NAME

     puffs_cc -- puffs continuation routines

LIBRARY

     puffs Convenience Library (libpuffs, -lpuffs)

SYNOPSIS

     #include <puffs.h>

     void
     puffs_cc_yield(struct puffs_cc *pcc);

     void
     puffs_cc_continue(struct puffs_cc *pcc);

     void
     puffs_cc_schedule(struct puffs_cc *pcc);

     struct puffs_cc *
     puffs_cc_getcc(struct puffs_usermount *pu);

DESCRIPTION

     These routines are used for the cooperative multitasking suite present in puffs.

     puffs_cc_yield(pcc)
	   Suspend and save the current execution context and return control to the previous point.  In practice, from the file system author per-
	   spective, control returns back to where either the mainloop or where puffs_dispatch_exec() was called from.

     puffs_cc_continue(pcc)
	   Will suspend current execution and return control to where it was before before calling puffs_cc_yield().  This is rarely called
	   directly but rather through puffs_dispatch_exec().

     puffs_cc_schedule(pcc)
	   Schedule a continuation.  As opposed to puffs_cc_continue() this call returns immediately.  pcc will be scheduled sometime in the
	   future.

     puffs_cc_getcc(pu)
	   Returns the current pcc or NULL if this is the main thread.	NOTE: The argument pu will most likely disappear at some point.

     Before calling puffs_cc_yield() a file system will typically want to record some cookie value into its own internal bookkeeping.  This cookie
     should be hooked to the pcc so that the correct continuation can be continued when the event it was waiting for triggers.	Alternatively, the
     puffs_framebuf(3) framework and puffs_mainloop() can be used for handling this automatically.

SEE ALSO

     puffs(3), puffs_framebuf(3)

BSD
								 January 28, 2008							       BSD

Check Out this Related Man Page

RUMP_SYSPUFFS(8)					    BSD System Manager's Manual 					  RUMP_SYSPUFFS(8)

NAME

     rump_syspuffs -- mount a puffs file server with a userspace puffs loop

SYNOPSIS

     file-system PUFFS
     pseudo-device putter

     rump_syspuffs file_server arguments

DESCRIPTION

     The rump_syspuffs utility can be used to mount any puffs(3) file server so that the requests are passed through the kernel puffs code in
     userspace as well.  Therefore the approximate callgraph looks a little like the following, where k and u denote code running in the kernel
     space and userspace, respectively: puffs vfs (k) -> libpuffs (u) -> p2k (u) -> puffs vfs (u) -> libpuffs (u) -> file server (u).  The
     response path is the same, but in reverse.

     In its current state, rump_syspuffs is most useful as a proof of concept for file system distribution and for developing and debugging the
     kernel portion of puffs.

EXAMPLES

     Mount a file system with sshfs:
	   rump_syspuffs mount_psshfs server.address /mnt

     Mount an ntfs file system using ntfs-3g (from pkgsrc/filesystems/fuse-ntfs-3g), set the default uid to 1323:
	   rump_syspuffs ntfs-3g -o uid=1323 /path/to/filesystem /mnt

SEE ALSO

     p2k(3), puffs(3), rump(3), puffs(4)

HISTORY

     The rump_syspuffs debugging utility first appeared in NetBSD 5.0.

BSD
								   June 9, 2009 							       BSD

Linux and UNIX Man Pages

puffs_cc(3) [netbsd man page]

Check Out this Related Man Page