Fl4m3Ph03n1x
Supervisor.start_link/2 documentation incomplete?
Background
I am trying to build an OTP compliant app using supervisors. However I am having trouble interpreting a part of the documentation.
Docs
The documentation states that Supervisor.start_link/2 returns the following:
{:ok, pid}
| :ignore
| {:error, {:already_started, pid} | {:shutdown,term} | [term]}
Problem
The problem is that even though the documentation specifies when start_link returns {:ok, pid} and {:error, any} it doesn’t specify when it returns :ignore, leaving me to think that it can never return :ignore.
Question
In which cases does Supervisor.start_link/2 return :ignore?
Marked As Solved
LostKobrakai
When the supervisor itself (it’s init/1) returns :ignore then Supervisor.start_link returns :ignore.
E.g.
defmodule MyApp.Supervisor do
# Automatically defines child_spec/1
use Supervisor
def start_link(init_arg) do
Supervisor.start_link(__MODULE__, init_arg, name: __MODULE__)
end
@impl true
def init(_init_arg) do
:ignore
end
end
Supervisor.start_link(MyApp.Supervisor, [])
# :ignore
Also Liked
LostKobrakai
It surely can if at least for the Supervisor.start_link/3 version, but skipping the optional options, which are the 3rd parameter.
LostKobrakai
If init/1 returns :ignore then start_link will return :ignore. This is useful if you want to selectively start certain parts of your supervision tree / workers.
It’s explicitly documented here GenServer — Elixir v1.20.2
peerreynders
The init/1 callback is allowed to return {:ok, {:supervisor.sup_flags(), [:supervisor.child_spec()]}} | :ignore
[Erlang] Designing for Scalability with Erlang/OTP (O'Reilly) p.81:
If the startup fails but you do not want to affect other processes started by the same supervisor, return
ignore.
p.178
The
init/1callback function normally returns the whole tuple comprising the restart tuple and a list of child specifications. But if it instead returnsignore, the supervisor terminates with reasonnormal.
Popular in Questions
Other popular topics
Latest on Elixir Forum
Sponsor Spotlight
Practical resources that improve the lives of professional developers.
Categories:
Sub Categories:
Forums
Popular Tags
- #ecto
- #liveview
- #troubleshooting
- #learning-elixir
- #deployment
- #library
- #erlang
- #testing
- #genserver
- #mix
- #absinthe
- #remote-other
- #otp
- #plug
- #how-to-question
- #macros
- #postgres
- #channels
- #elixirconf
- #exunit
- #discussion
- #code-sync
- #javascript
- #podcasts
- #onsite
- #dialyzer
- #docker
- #authentication
- #umbrella
- #full-time-contract
- #podcasts-by-brainlid
- #ecto-query
- #elixir-ls
- #phoenix_html
- #iex
- #blog-post
- #graphql
- #genstage
- #ai
- #websockets
- #supervisor
- #advent-of-code
- #elixirconf-us
- #distillery
- #processes
- #forms
- #api
- #metaprogramming
- #security
- #performance
Our Sponsors
Build Elixir applications with speed and confidence.
Supporting innovation across the BEAM ecosystem.
We build reliable cloud platforms for business-critical systems.
Catch errors, track performance, monitor hosts and more.
Real-time error tracking, performance insights, and observability for devs.
Develop your skills with books, videos, and courses.
Enabling companies to succeed by building software people love.
The deployment platform built for Elixir: PaaS ease, VPS control.
Courses that'll move you from confusion to "Aha, now I get it!"