Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
system_collapse(3)		 Arcan Lua API		    system_collapse(3)

NAME
       system_collapse	-  Collapse  important subsystems, leaving only	frame-
       servers alive.

SYNOPSIS
       nil
       system_collapse(

       applname, noadopt )

DESCRIPTION
       This function purges audio/video/events from  everything	 not  strictly
       related to frameservers.	Then, if applname  was specified, it loads and
       runs  applname	and invokes an applname_adopt function for each	frame-
       server related VID , unless noadopt  has	been set to true. This enables
       recovery	from bad system	states switching to an app that	can permit the
       user to clean-up	and save important information that would otherwise be
       lost or simply to switch	active scripts while keeping core services in-
       tact. If	applname  is left undefined, the current namespaces and	active
       scripts will be re-used but the scripting context will be reset.

NOTES
       1      frameservers existing in multiple	context	stack levels are  col-
	      lated down to a flat, new	context.

       2      if the number of running frameservers is higher than the current
	      new context vobj limit, the vobj limit will be raised.

       3      if  there	are more running frameservers in all contexts combined
	      than what	is permitted (compile-time) some frameservers will  be
	      truncated	 and  deleted.	 (likely to hit	system process and de-
	      scriptor limits before that happens).

       4      frameservers will	have their order value set  depending  on  the
	      context they were	previously allocated in.

       5      the  search  space for applname  is constrained to namespace de-
	      fined by the APPLBASE  namespace.

SEE ALSO:
system				  April	2025		    system_collapse(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=system_collapse&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help