# System.stop(1) does not return code to shell

**URL:** <https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542>\
**Category:** Questions\
**Tags:** escript\
**Created:** [October 26, 2018, 11:12am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542 "2018-10-26T11:12:28Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![Phillipp](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/phillipp/32/10625_2.png) [@Phillipp](https://forum.elixirforum.com/u/Phillipp)\
**Post date:** [October 26, 2018, 11:12am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/1 "2018-10-26T11:12:28Z")

</div>

Hey,

I am developing an escript and want to return the code `1` to the shell in case of an error, so if my tool gets automated, the automation scripts can detect an error based on the returned code.

So, to keep it simply, we return right from the `main` function of my escript entrypoint module:

```elixir
  def main(_args) do
    System.stop(1)
  end

```

Then after I run my generated escript:

```elixir
$ echo $?
0

```

Am I right that there should be a `1` instead of a `0`?

---

<div class="post-metadata">

**Author:** ![josevalim](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/josevalim/32/1787_2.png) [@josevalim](https://forum.elixirforum.com/u/josevalim)\
**Post date:** [October 26, 2018, 11:20am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/2 "2018-10-26T11:20:58Z")

</div>

Here it works from IEx:

```elixir
$ iex
Erlang/OTP 21 [erts-10.0] [source] [64-bit] [smp:4:4] [ds:4:4:10] [async-threads:1] [hipe]

Interactive Elixir (1.8.0-dev) - press Ctrl+C to exit (type h() ENTER for help)
iex(1)> System.stop(1)
:ok
$ echo $?
1

```

So it may be a bug with escripts in Erlang/OTP? I would try to build a minimal erlang escript and see if you can reproduce it there. If so, that’s the bug. 🙂 `System.stop(1) ` is `init:stop(1)` in Erlang.

---

<div class="post-metadata">

**Author:** ![NobbZ](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/nobbz/32/27235_2.png) [@NobbZ](https://forum.elixirforum.com/u/NobbZ)\
**Post date:** [October 26, 2018, 11:32am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/3 "2018-10-26T11:32:19Z")

</div>

How do you build and run that escript? Are you using a shell wrapper around it?

Can you perhaps provide a minimal project in GitHub that reproduces the issue? I never experienced any problems.

---

<div class="post-metadata">

**Author:** ![Phillipp](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/phillipp/32/10625_2.png) [@Phillipp](https://forum.elixirforum.com/u/Phillipp)\
**Post date:** [October 26, 2018, 11:44am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/5 "2018-10-26T11:44:20Z")

</div>

Yes, seems to fail in the erlang escript too:

```elixir
~/Private/Code/Tests/erlang_escript_test$ cat escript_test
#!/usr/local/bin/escript
%% -*- erlang -*-
%%! -smp enable -sname factorial -mnesia debug verbose
main(_) ->
    io:format("simple example\n"),
    init:stop(1).
~/Private/Code/Tests/erlang_escript_test$ ./escript_test
simple example
~/Private/Code/Tests/erlang_escript_test$ echo $?
0

```

---

<div class="post-metadata">

**Author:** ![elbrujohalcon](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/elbrujohalcon/32/1912_2.png) [@elbrujohalcon](https://forum.elixirforum.com/u/elbrujohalcon)\
**Post date:** [October 26, 2018, 11:54am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/6 "2018-10-26T11:54:34Z")

</div>

I tried with…

```
defmodule Excript.CLI do
  def main(args \\ []) do
    {opts, _, _} = OptionParser.parse(args, switches: [halt: :boolean])
    if opts[:halt], do: System.halt(1), else: System.stop(1)
  end
end

```

…and could definitely reproduce the error, see:

```
$ ./excript --halt
$ echo $?
1
$ ./excript
$ echo $?
0

```

As @Phillipp says… it’s an issue with erlang escripts.

---

<div class="post-metadata">

**Author:** ![elbrujohalcon](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/elbrujohalcon/32/1912_2.png) [@elbrujohalcon](https://forum.elixirforum.com/u/elbrujohalcon)\
**Post date:** [October 26, 2018, 11:56am UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/7 "2018-10-26T11:56:57Z")

</div>

It’s actually already reported [since 2014](http://erlang.org/pipermail/erlang-bugs/2014-June/004450.html) 🤦‍♂️

---

<div class="post-metadata">

**Author:** ![Phillipp](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/phillipp/32/10625_2.png) [@Phillipp](https://forum.elixirforum.com/u/Phillipp)\
**Post date:** [October 26, 2018, 12:03pm UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/8 "2018-10-26T12:03:15Z")

</div>

Ha, that’s a shame. I Just checked, `System.halt(1)` does work properly but it does not carefully shut down the VM. I assume it won’t cause any troubles in my case, but we can’t be sure about it.

---

<div class="post-metadata">

**Author:** ![josevalim](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/josevalim/32/1787_2.png) [@josevalim](https://forum.elixirforum.com/u/josevalim)\
**Post date:** [October 26, 2018, 1:38pm UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/9 "2018-10-26T13:38:46Z")

</div>

Usually it is fine for escripts and sometimes even desired for faster shutdown. The difference is that System.halt() does not shutdown the applications supervision trees one by one. It just halts the system.

---

<div class="post-metadata">

**Author:** ![OvermindDL1](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/overminddl1/32/2677_2.png) [@OvermindDL1](https://forum.elixirforum.com/u/OvermindDL1)\
**Post date:** [October 26, 2018, 3:44pm UTC](https://forum.elixirforum.com/t/system-stop-1-does-not-return-code-to-shell/17542/10 "2018-10-26T15:44:57Z")

</div>

> [@josevalim](#):
>
> Usually it is fine for escripts and sometimes even desired for faster shutdown. The difference is that System.halt() does not shutdown the applications supervision trees one by one. It just halts the system.

You can always manually shut down parts that need to be shut down cleanly before calling it though (just don’t shut down the kernel before you get a chance to call halt). 🙂
