source: mainline/uspace/lib/c/generic/context.c@ a35a3d8

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since a35a3d8 was a35a3d8, checked in by GitHub <noreply@…>, 7 years ago

Turn context_save/context_restore into standard setjmp/longjmp. (#24)

Turn context_save()/context_restore() into semi-standard __setjmp()/__longjmp().

The original context_* functions are similar to setjmp()/longjmp(), except that the return value is more restricted for the former, and with inverted meaning. This commit adopts the standard return value semantics and acknowledges that these functions are "standard setjmp()/longjmp() with additional implementation-specific properties" by changing the name. The only divergence from the standard is that __longjmp() causes __setjmp() to return its value unchanged, even if it is zero. This is just to avoid extra assembly, and longjmp() checks this in C.

Note that the original use of context_save()/context_restore() to implement context switching in fibril implementation has already been delegated to context_create()/context_swap(), which provide more natural control flow.

  • Property mode set to 100644
File size: 2.5 KB
Line 
1/*
2 * Copyright (c) 2018 CZ.NIC, z.s.p.o.
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29#include <context.h>
30#include <setjmp.h>
31#include <libarch/tls.h>
32#include <libarch/fibril.h>
33#include <libarch/faddr.h>
34
35/**
36 * Saves current context to the variable pointed to by `self`,
37 * and restores the context denoted by `other`.
38 *
39 * When the `self` context is later restored by another call to
40 * `context_swap()`, the control flow behaves as if the earlier call to
41 * `context_swap()` just returned.
42 */
43void context_swap(context_t *self, context_t *other)
44{
45 if (!__setjmp(self))
46 __longjmp(other, 1);
47}
48
49void context_create(context_t *context, const context_create_t *arg)
50{
51 __setjmp(context);
52 context_set(context, FADDR(arg->fn), arg->stack_base,
53 arg->stack_size, arg->tls);
54}
55
56uintptr_t context_get_pc(context_t *ctx)
57{
58 // This is a simple wrapper for now, and exists to allow
59 // potential future implementation of context_swap to omit
60 // program counter from the context structure (e.g. if it's
61 // stored on the stack).
62 return ctx->pc;
63}
64
65uintptr_t context_get_fp(context_t *ctx)
66{
67 return _context_get_fp(ctx);
68}
Note: See TracBrowser for help on using the repository browser.