xref: /petsc/doc/miscellaneous/saws.md (revision 49c2f9045d3a91e7be182f7f53e05380f8af9fad)
1*9b92b1d3SBarry Smith# SAWs - Scientific Application Webserver
2*9b92b1d3SBarry Smith
3*9b92b1d3SBarry SmithSAWs is a software library that uses threads, sockets, and locks to
4*9b92b1d3SBarry Smithallow a client program to read (and change when desired) variables in
5*9b92b1d3SBarry Smiththe server (PETSc) application).
6*9b92b1d3SBarry Smith
7*9b92b1d3SBarry Smith## Requirements and installation of the SAWs
8*9b92b1d3SBarry Smith
9*9b92b1d3SBarry SmithOne can simply add `--download-saws` to the arguments for `./configure` when configuring PETSc.
10*9b92b1d3SBarry Smith
11*9b92b1d3SBarry SmithAlternately, a current version of SAWs is available from `https://bitbucket.org/saws/saws`
12*9b92b1d3SBarry Smithand one can add the flag `--with-saws-dir=/directorywhereamsisinstalled`.
13*9b92b1d3SBarry Smith
14*9b92b1d3SBarry Smith## Usage from PETSc
15*9b92b1d3SBarry Smith
16*9b92b1d3SBarry SmithTo examine options in a browser, run PETSc applications with
17*9b92b1d3SBarry Smith`-saws_view saws -ts_view_pre saws` and point your brower to
18*9b92b1d3SBarry Smith`http://localhost:8080` or, if you are running your application on a
19*9b92b1d3SBarry Smithdifferent machine, pass the name of that machine to the browser.
20