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 frameservers
     alive.

SYNOPSIS
     nil
     system_collapse( applname, noadopt )

DESCRIPTION
     This function purges audio/video/events from everything  not  strictly  re-
     lated  to frameservers. Then, if applname	was specified, it loads and runs
     applname  and invokes an applname_adopt function for each	frameserver  re-
     lated  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 intact. If  ap-
     plname    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	collated
	    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 descriptor limits
	    before that happens).

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

     5	    the  search  space for applname  is constrained to namespace defined
	    by the APPLBASE  namespace.

SEE ALSO:
system				   August 2026		      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+15.1.quarterly>

home | help