Add docs for using LLVM toolchain with Webassembly by jakelang · Pull Request #46 · ewasm/testnet

jakelang · 2018-06-20T23:19:53Z

Closes #111.

c2wasm.md

jwasinger

@jakelang can you address the suggested changes to this PR?

lrettig · 2018-09-24T19:33:59Z

Ping @jakelang

jakelang · 2018-09-25T02:49:22Z

@lrettig yo this PR is dead pretty much, I plan to migrate this stuff over to the readthedocs site.

axic · 2018-11-27T12:38:27Z

c2wasm.md

+
+## Install LLVM and Clang with the WASM backend
+
+### From the repo


Should offer the option to use the docker image we have.

jakelang · 2018-12-04T20:06:29Z

I want to rewrite this. closing

axic · 2018-12-04T22:17:36Z

Please don't close. I'll cherry pick from it then.

axic · 2018-12-05T20:42:43Z

Rebased on top of #132.

axic · 2018-12-05T20:43:39Z

clang.md

 cd ../projects
 git clone http://llvm.org/git/compiler-rt.git
+
+Then initialize CMake:


Not sure why these two steps needs to be separate (initialise + build).

helps to annotate

axic · 2018-12-05T20:44:09Z

clang.md

- compiling to WebAssembly binary (`wasm-as`)
+First we must compile C to LLVM bitcode through the Clang frontend:

-Note: the last step can also be accomplished with [wabt](https://github.com/webassembly/wabt) (previously called *sexpr-wasm-prototype*).


I think we can keep this note.

actually the list of steps is gone and we need binaryen anyway for s2wasm

axic · 2018-12-05T20:44:25Z

clang.md

-s2wasm -o hello.wast hello.s
-wasm-as -o hello.wasm hello.wast
-```
+Next we can generate linear WASM output from the bitcode:


What is a "linear WASM output" ?

The linear assembly format that WASM specifies

also i stopped maintaining this a while ago.

The linear assembly format that WASM specifies

I'm also not sure what this means. Could you link to another doc that explains this?

axic · 2018-12-05T20:45:00Z

Also needs to include a note about wasm-chisel (can copy it off the Rust PR)

axic · 2018-12-05T20:45:35Z

clang.md

+`s2wasm -o main.wast main.s`

-There you go, you have your very first WebAssembly binary.
+The code will now be in WAST format but must be cleaned up with `ewasm-cleanup` to be deployed as a contract.


Refer to wasm-chisel instead of ewasm-cleanup.

axic · 2018-12-05T21:14:50Z

s2wasm was removed in June from binaryen and apparently now clang supports the whole process by clang hello.c -o hello.wasm --target=wasm32 -nostdlib -Xlinker --no-entry -Xlinker --allow-undefined.

Also https://aransentin.github.io/cwasm/

poemm · 2018-12-08T19:50:05Z

@jakelang Great work with this! I see so much overlap between this and #134, including compiling llvm toolchain and binaryen. To make progress, can we merge 134, and later add contents here to the advanced section of 134?

lrettig · 2018-12-27T11:48:10Z

clang.md

+
+## Install Binaryen
+
+This one is much easier. Simply:


Could you link to the binaryen master install docs here? In case these steps change or something.

lrettig · 2018-12-27T11:50:26Z

clang.md


-## Rolling your own compiler
+Many high level languages already support compilation to WebAssembly
+through the experimental LLVM backend. Unfortunately, it is a tedious


experimental LLVM backend

Could you please add a link to further documentation on this? Why is it "experimental"?

lrettig · 2018-12-27T11:53:56Z

clang.md

 ```

-## Using this compiler
+CMake will also generate an `install` target if you want to actually install Binaryen on your system.


How would you run this? cmake install? Could you please make that explicit here?

lrettig · 2018-12-27T11:55:43Z

clang.md

+`s2wasm -o main.wast main.s`

-There you go, you have your very first WebAssembly binary.
+The code will now be in WAST format but must be cleaned up with [wasm-chisel](https://github.com/wasmx/wasm-chisel) to be deployed as a contract.


must be cleaned up with wasm-chisel

Could you please make it explicit how to do this? Is it just a command you need to run? Do you need to clone the repo and compile and run? Etc.

lrettig · 2018-12-27T11:56:14Z

clang.md

-s2wasm -o hello.wast hello.s
-wasm-as -o hello.wasm hello.wast
-```
+Next we can generate linear WASM output from the bitcode:


The linear assembly format that WASM specifies

I'm also not sure what this means. Could you link to another doc that explains this?

jakelang added the in progress label Jun 20, 2018

lrettig added review and removed in progress labels Jun 20, 2018

jakelang requested review from axic, cdetrio, hugo-dc, jwasinger and lrettig August 16, 2018 21:46

lrettig requested changes Aug 16, 2018

View reviewed changes

c2wasm.md Outdated Show resolved Hide resolved

c2wasm.md Outdated Show resolved Hide resolved

c2wasm.md Outdated Show resolved Hide resolved

c2wasm.md Outdated Show resolved Hide resolved

c2wasm.md Outdated Show resolved Hide resolved

c2wasm.md Outdated Show resolved Hide resolved

hugo-dc reviewed Aug 16, 2018

View reviewed changes

c2wasm.md Outdated Show resolved Hide resolved

jwasinger reviewed Aug 26, 2018

View reviewed changes

jakelang closed this Sep 25, 2018

axic removed the review label Sep 25, 2018

axic reopened this Nov 27, 2018

axic reviewed Nov 27, 2018

View reviewed changes

jakelang closed this Dec 4, 2018

axic reopened this Dec 4, 2018

axic force-pushed the c2wasm branch 4 times, most recently from 3e29617 to 0457722 Compare December 5, 2018 19:26

Improve clang documentation

4d72864

axic force-pushed the c2wasm branch from 0457722 to 4d72864 Compare December 5, 2018 20:42

axic reviewed Dec 5, 2018

View reviewed changes

jakelang and others added 6 commits December 5, 2018 15:47

Add docs for using LLVM toolchain with Webassembly

c22dc74

formatting

c62f155

formatting 2

f9e7757

moar formatting

ada8786

remove package manager specific docs

39cd72a

f

ff66ae7

Some minor tweaks

7742ce1

lrettig requested changes Dec 27, 2018

View reviewed changes

Lane Rettig added 2 commits December 27, 2018 07:42

Add link on linear wasm

cfc05d5

Wasm/wast should not be uppercase

8357623

lrettig mentioned this pull request Dec 28, 2018

add C/C++ guide #134

Open


		## Install LLVM and Clang with the WASM backend

		### From the repo

Conversation

jakelang commented Jun 20, 2018 • edited by axic Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jwasinger left a comment

Choose a reason for hiding this comment

Uh oh!

lrettig commented Sep 24, 2018

Uh oh!

jakelang commented Sep 25, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jakelang commented Dec 4, 2018

Uh oh!

axic commented Dec 4, 2018

Uh oh!

axic commented Dec 5, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

axic commented Dec 5, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

axic commented Dec 5, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

poemm commented Dec 8, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

jakelang commented Jun 20, 2018 •

edited by axic

Loading

axic commented Dec 5, 2018 •

edited

Loading