.. sesf documentation master file, created by sphinx-quickstart on Wed Oct 4 21:30:41 2017. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Welcome to SESF: testing branch ================================== Sesf is a framework to write provably-correct **multi-threaded distributed programs**, test them in distributed execution, and prove their correctness. At the core of Sesf is a convenient way to specify the intended behaviour of a multi-threaded distributed program. The resulting specification, referred to as a "service", yields a program for testing implementations of the service as well as a program for testing users of the service. In a distributed system, any distributed subsystem can be replaced by another distributed subsystem satisfying the same service without disturbing correctness. Sesf can be applied in any programming language. Here we apply it in Python, focusing on implementation and testing. The examples here have been tested in Python 3.5, but they would work with minor changes in Python 2. There is a parallel `sesf correctness branch <../../analysis/sesf_correctness.pdf>`_. that focuses on proofs of correctness and uses a compact Python-like syntax for programs. Multi-threaded distributed programs -------------------------------------- An executing multi-threaded distributed program consists of one or more processes, each with one or more threads. Threads within a process typically interact via shared memory. Threads in different processes interact via message passing. Each process executes a program, and these programs together constitute the **distributed program**. The illustration below shows a distributed program AB consisting of multiple processes, each executing a program *ab*. In addition to the *internal* interactions between its *ab* processes, the distributed program has *external inputs and outputs* via which it provides a distributed service X. For example, *ab* could be a TCP program and X could be stream internet sockets. .. Of course, the processes need not execute the same program; the illustration assumes so for convenience. .. image:: intro-distAB.svg :width: 640 px :align: center :alt: Distributed program of *ab* processes and its external inputs and outputs The illustration below shows a distributed program CD, consisting of processes each executing a program *cd*, that makes use of the service X provided by the distributed program AB, and in turn provides a distributed service Y (eg, file transfer). .. There need not be a one-to-one mapping of *cd* processes to *ab* processes; the illustration assumes so for convenience. .. image:: intro-distAB+distCD.svg :width: 600 px :align: center :alt: Distributed program of *cd* processes using the distributed *ab* program. Services -------- A key step in writing a correct program is to come up with a precise description of what the program is supposed to do, that is, its intended service. Fundamentally, this amounts to a precise description of the **acceptable sequences of the external inputs and outputs** of the program. The program is **correct** if every one of its possible input-output sequences is acceptable to the service: that is, at any point in the program's execution, it can take in any acceptable input and only generate an acceptable output. (This is made precise later.) Defining the service for a multi-threaded program is more complicated than for a single-threaded program. Because of concurrent threads in the program, a variety of outputs can happen at any point. Similarly, because of concurrent threads in the environment, a variety of inputs can happen at any point. The service must allow for these possibilites when defining the set of acceptable input-output sequences. We have additional requirements of a service. It should be easily understandable to humans, in particular, much more so than a typical implementation. It should enable testing and verification of programs that implement the service. It should enable testing and verification of programs that use the service. In Sesf, a service is defined by a special kind of program, referred to as a **service program**. There are actually two versions of the service program: an **abstract** version, where the set of possible outputs are defined by predicates; and a **concrete** version, where these predicates are replaced by code that randomly selects a possible output. The former is for reading and analysis. The latter serves as a "stub implementation" for testing. **Correctly using a service:** Given an application program that makes use of a service, the composite program of the application program and the abstract service program can be analyzed to *prove* that the application correctly uses the service. The same composite program, but now using the concrete service program, can be executed to *test* that the application correctly uses the service. The application, being distributed, would access the service program via remote procedure calls. For the above example of application program CD using service X, this composite program is illustrated below. .. image:: intro-distCD+serviceX.svg :width: 600 px :align: center :alt: Composite program of distributed program CD and X.service program. Because of its special structure, a service program can be "inverted" to yield a so-called **servicetester program**, which can send arbitrary acceptable inputs to an implementation and check whether the implementation's outputs are acceptable. The servicetester program also comes in abstract and concrete versions. **Correctly implementing a service:** Given an implementation program for a service, the composite program of the abstract servicetester program and the implementation program can be analyzed to *prove* the correctness of the implementation. The composite program, but now using the concrete servicetester program, can be executed to *test* the correctness of the implementation. For the above example of implementation program AB for service X, this composite program is illustrated below. .. _servicetester+implementation: .. image:: intro-distAB+servicetesterX.svg :width: 600 px :align: center :alt: Composite program of X.servicetester program and distributed program AB. **Compositionality** is the payoff for correctly using services and correctly implementing services. If a distributed program correctly uses a service X to achieve a correctness property, which could include implementing another service Y, then replacing the service X by any correct implementation of X preserves the correctness property. In our example above, program CD will implement service Y correctly if service X is replaced by any program that implements X correctly. Establishing correctness ------------------------- A typical multi-threaded program, whether in one process or multiple processes, has an unbounded number of possible executions. Testing can examine only a small subset of these executions. To claim correctness requires program analysis. There are various analysis methods. We use **assertional reasoning**. Here, one invents a sequence of assertions, ultimately ending with assertions that imply the intended service. Each assertion is shown to hold for the program given previous assertions, via operational arguments or proof-rule applications. The latter can be mechanically checked (by theorem provers or, in the case of finite-state programs, by model checkers). An **assertion** is a boolean condition evaluated on an execution of the program. It can relate variables within a process and also across processes, eg, an account balance displayed in a web client tracks the account balance stored in the server's database. An assertion holds for the program if it holds for *every* possible execution. (There are different kinds of assertions: we mostly use "invariant" assertions and "leads-to" assertions.) Assertions are useful even if they are not formally proved. They are an unambiguous and convenient way of stating properties of the program. Furthermore, assertions, even global assertions, which relate variables across different processes, can be checked in the servicetester during testing. Background ------------ The theory and proofs here are extracted, with some changes in treatment and terminology, from the text `Distributed Programming: Theory and Practice `_. Sesf stands for "Services and Systems Framework". The term **service** has been introduced above. We use the term **system** to refer to an executing program, a part of an executing program, or a (perhaps dynamic) collection of executing programs. So unlike a process in operating systems terminology, a system may span a part of one address space or multiple address spaces. What's next ----------- The rest of this material is essentially a succession of sesf applications, focussing on testing. Each sesf application typically consists of the following: - Service program defining a desired service, both abstract and concrete versions. - Corresponding servicetester program, both abstract and concrete versions. - One or more implementation programs, which may use services defined in other applications. - Proof of correctness for each implementation. The proof is in a separate pdf document in the `sesf correctness branch <../../analysis/sesf_correctness.pdf>`_. You can skip it if you are not into proofs of program correctness. - Simple user program to exercise an implementation or the service program. - RPC (remote-procedure-call) harness for connecting any implementation to the servicetester program. - RPC harness for connecting any user program to the service program. You can execute the servicetester and an implementation, to test that the implementation satisfies the service and any implementation-specific assertions (from the correctness proof or ones you make up). You can execute a user program, either the given one or one that you write, over the service program, to test that the user program correctly uses the service. You can execute a user program over an implementation program. If the latter itself uses a service, that too can be replaced by an implementation, and so on, resulting in a multi-layered distributed system. (The above example with programs AB and CD is one with two layers.) .. `Sesf-theory branch <../../analysis/sesf.pdf>`_ `Sesf-theory branch page 3 <../../analysis/sesf.pdf#page=3>`_ `Assertional analysis display:semaphore <../../analysis/a.pdf#cname.display:semaphore>`_ ---------------------------------- .. toctree:: :maxdepth: 2 :numbered: 1 :caption: Contents: rwlock/rwlock conventions/conventions msgtransfer2/msgtransfer2 distlock2/distlock2 msgtransfer/msgtransfer objtransfer/objtransfer Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search`