Source Code Guide - Revision history

Dimitri at 09:14, 10 August 2025

2025-08-10T09:14:56Z

← Older revision		Revision as of 09:14, 10 August 2025
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros main git repository] can be browsed online. We have ~~mirrors~~ on [https://~~github.com/dstaesse/ouroboros github] or [https://bitbucket~~.org/~~dstaesse~~/ouroboros ~~bitbucket~~] if you prefer. <br/>		The [https://ouroboros.rocks/cgit/ouroboros main git repository] can be browsed online. We have a main mirror on [https://codeberg.org/o7s/ouroboros codeberg]if you prefer.<br/>
	For bug reports, feature requests or contributions (including git guidelines), see [[Ouroboros Contributions\|the contact page]].		For bug reports, feature requests or contributions (including git guidelines), see [[Ouroboros Contributions\|the contact page]].

Thijs: Add library lifespan

2024-01-05T12:03:24Z

Add library lifespan

← Older revision		Revision as of 12:03, 5 January 2024
Line 125:		Line 125:
	fini() / destroy()		fini() / destroy()
	</syntaxhighlight>		</syntaxhighlight>

			==== Library lifespan ====
			Ouroboros is provided as a shared library <ref>the <code>*.so</code> files on Linux, in the ELF format</ref> to dynamically link against.
			When a program dynamically linking to <code>ouroboros-dev</code> (like e.g. <code>oecho</code>) is started, it automatically loads this shared library at load time.
			The Ouroboros dynamic library has some [http://ftp.math.utah.edu/u/ma/hohn/linux/misc/elf/node3.html .init and .fini sections]
			<ref>Actually, for O7s they are <code>.init_array</code>/<code>.fini_array</code> on most platforms, but [https://maskray.me/blog/2021-11-07-init-ctors-init-array the idea remains the same].</ref>
			containing the <code>init()</code>/<code>fini()</code> functions, which are run when (un)loaded.

			Interesting to know is that this <code>init()</code> function will <code>exit</code> the process if the IRMd is not reachable.
			Thus, the process is stopped at load time, meaning that even a simple <code>oecho --help</code> will not work.
			This is intended, because ultimately, the IRMd is considered part of the always present Operating System (and no threads should be actively waiting for this invariant).
			The <code>--help</code> case is unusual enough for networked applications that we don't want to design against the actual goals/principles
			<ref name="init-goals">At some point, we want to get rid of the POSIX sockets and bootstrap/run all IPC over O7s, and when that is the case, the IRMd needs to be up at init.
			That is one of the promises of the prototype: unification of all IPC and networking.</ref>.

			A workaround is loading the shared library at ''runtime'', only when needed to start the communication.
			This uses e.g. <code>dlopen()</code>/<code>dlclose()</code>/... .
			In fact, an early implementation required a call to <code>ouroboros_init()</code> and <code>ouroboros_fini()</code>, but this is not ergonomic nor aligned with the goals<ref name="init-goals" />.
			<ref>Another possibility for the O7s library is to hide this in e.g. <code>flow_alloc()</code>, but it would be inefficient to check this each time.</ref>

			==Notes==
			<references />

Thijs at 16:02, 10 December 2023

2023-12-10T16:02:15Z

← Older revision		Revision as of 16:02, 10 December 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros main git repository] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer.		The [https://ouroboros.rocks/cgit/ouroboros main git repository] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer. <br/>
			For bug reports, feature requests or contributions (including git guidelines), see [[Ouroboros Contributions\|the contact page]].

	== Directory structure ==		== Directory structure ==

Dimitri at 12:02, 25 November 2023

2023-11-25T12:02:56Z

← Older revision		Revision as of 12:02, 25 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros main git repository~~] and [https://ouroboros.rocks/man/man8/ouroboros.8.html man pages~~] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer.		The [https://ouroboros.rocks/cgit/ouroboros main git repository] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer.

	== Directory structure ==		== Directory structure ==

Dimitri at 12:02, 25 November 2023

2023-11-25T12:02:36Z

← Older revision		Revision as of 12:02, 25 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros git repository] and [https://ouroboros.rocks/man/man8/ouroboros.8.html man pages] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer.		The [https://ouroboros.rocks/cgit/ouroboros main git repository] and [https://ouroboros.rocks/man/man8/ouroboros.8.html man pages] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer.

	== Directory structure ==		== Directory structure ==

Dimitri at 12:02, 25 November 2023

2023-11-25T12:02:23Z

← Older revision		Revision as of 12:02, 25 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros git repository] and [https://ouroboros.rocks/man/man8/ouroboros.8.html man pages] can be browsed online.		The [https://ouroboros.rocks/cgit/ouroboros git repository] and [https://ouroboros.rocks/man/man8/ouroboros.8.html man pages] can be browsed online. We have mirrors on [https://github.com/dstaesse/ouroboros github] or [https://bitbucket.org/dstaesse/ouroboros bitbucket] if you prefer.

	== Directory structure ==		== Directory structure ==

Dimitri at 10:18, 25 November 2023

2023-11-25T10:18:06Z

← Older revision		Revision as of 10:18, 25 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros git repository] and [https://ouroboros.~~rock~~/man/ man pages] can be browsed online.		The [https://ouroboros.rocks/cgit/ouroboros git repository] and [https://ouroboros.rocks/man/man8/ouroboros.8.html man pages] can be browsed online.

	== Directory structure ==		== Directory structure ==

Dimitri at 10:17, 25 November 2023

2023-11-25T10:17:00Z

← Older revision		Revision as of 10:17, 25 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	The [https://ouroboros.rocks/cgit/ouroboros git repository] can be browsed online.		The [https://ouroboros.rocks/cgit/ouroboros git repository] and [https://ouroboros.rock/man/ man pages] can be browsed online.

	== Directory structure ==		== Directory structure ==

Dimitri at 11:30, 19 November 2023

2023-11-19T11:30:57Z

← Older revision		Revision as of 11:30, 19 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

			The [https://ouroboros.rocks/cgit/ouroboros git repository] can be browsed online.

	== Directory structure ==		== Directory structure ==

Dimitri: Dimitri moved page Source code guide to Source Code Guide without leaving a redirect

2023-11-08T11:03:13Z

Dimitri moved page Source code guide to Source Code Guide without leaving a redirect

← Older revision	Revision as of 11:03, 8 November 2023
(No difference)