--- pth.pod 2004/10/08 16:17:02 1.164
+++ pth.pod 2004/12/03 16:21:08 1.165
@@ -142,8 +142,6 @@
pth_uctx_create,
pth_uctx_make,
-pth_uctx_save,
-pth_uctx_restore,
pth_uctx_switch,
pth_uctx_destroy.
@@ -1520,8 +1518,8 @@
This function creates a user-space context and stores it into I<uctx>.
There is still no underlying user-space context configured. You still
-have to do this with pth_uctx_make(3) or pth_uctx_set(3). On success,
-this function returns C<TRUE>, else C<FALSE>.
+have to do this with pth_uctx_make(3). On success, this function returns
+C<TRUE>, else C<FALSE>.
=item int B<pth_uctx_make>(pth_uctx_t I<uctx>, char *I<sk_addr>, size_t I<sk_size>, const sigset_t *I<sigmask>, void (*I<start_func>)(void *), void *I<start_arg>, pth_uctx_t I<uctx_after>);
@@ -1538,41 +1536,24 @@
after POSIX makecontext(3). On success, this function returns C<TRUE>,
else C<FALSE>.
-=item int B<pth_uctx_save>(pth_uctx_t I<uctx>);
-
-This function saves the current user-space context in I<uctx> for later
-restoring by either pth_uctx_restore(3) or pth_uctx_switch(3). This
-function is somewhat modeled after POSIX getcontext(3). If I<uctx> is
-C<NULL>, C<FALSE> is returned instead of C<TRUE>. This is the only error
-possible.
-
-=item int B<pth_uctx_restore>(pth_uctx_t I<uctx>);
-
-This function restores the current user-space context from I<uctx>,
-which previously had to be set with either pth_uctx_make(3) or
-pth_uctx_save(3). This function is somewhat modeled after POSIX
-setcontext(3). If I<uctx> is C<NULL> or I<uctx> contains no valid
-user-space context, C<FALSE> is returned instead of C<TRUE>. These are
-the only errors possible.
-
=item int B<pth_uctx_switch>(pth_uctx_t I<uctx_from>, pth_uctx_t I<uctx_to>);
This function saves the current user-space context in I<uctx_from> for
-later restoring by either pth_uctx_restore(3) or pth_uctx_switch(3) and
-restores the new user-space context from I<uctx>, which previously
-had to be set with either pth_uctx_make(3) or pth_uctx_save(3). This
-function is somewhat modeled after POSIX swapcontext(3). If I<uctx_from>
-or I<uctx_to> are C<NULL> or if I<uctx_to> contains no valid user-space
-context, C<FALSE> is returned instead of C<TRUE>. These are the only
-errors possible.
+later restoring by another call to pth_uctx_switch(3) and restores
+the new user-space context from I<uctx_to>, which previously had to
+be set with either a previous call to pth_uctx_switch(3) or initially
+by pth_uctx_make(3). This function is somewhat modeled after POSIX
+swapcontext(3). If I<uctx_from> or I<uctx_to> are C<NULL> or if
+I<uctx_to> contains no valid user-space context, C<FALSE> is returned
+instead of C<TRUE>. These are the only errors possible.
=item int B<pth_uctx_destroy>(pth_uctx_t I<uctx>);
This function destroys the user-space context in I<uctx>. The run-time
stack associated with the user-space context is deallocated only if it
-was given by the application (see I<sk_addr> of pth_uctx_create(3)).
-If I<uctx> is C<NULL>, C<FALSE> is returned instead of C<TRUE>. This
-is the only error possible.
+was not given by the application (see I<sk_addr> of pth_uctx_create(3)).
+If I<uctx> is C<NULL>, C<FALSE> is returned instead of C<TRUE>. This is
+the only error possible.
=back
|
