FreeBSD Manual Pages
target_devicehint(3) Arcan Lua API target_devicehint(3) NAME target_devicehint - Change connection- and device- use for a frameserver connection SYNOPSIS nil target_devicehint( vid:dsrv, number:device ) target_devicehint( vid:fsrv, string:target ) target_devicehint( vid:fsrv, string:target, bool:force(=false) ) DESCRIPTION This function serves several uses. The first use case is to forward a de- vice handle to an accelerated client. This will happen if the device argu- ment is provided and matches a valid card identifier. If an invalid identi- fier is provided, the call will only be interpreted as a mode hint. The mode argument can also be specified as device-use hint. Previously, this has been used to indicate of the client should produce a buffer for direct output on the device in question, but this is now done heuristically as part of map_video_display calls. The valid values now are DEVICE_INDIRECT for composed rendering, and DEVICE_LOST to indicate that the currently used GPU should be dropped and, if possible, revert to software- defined graphics. The other uses are with a string target. This is used to indicate a connection point to another arcan-shmif capable server. The default is to mark this as a hint, 'in the event of the main connection being lost, please go here'. If the force argument is also set, the connection may be forcibly severed to make the client switch to the specified connection point. The target string is assumed to match the valid rules for a connec- tion point, but if the association is not forced, an empty string is also valid and will be interpreted as disabling a previously set alternate con- nection. There are two special forms to the target string, one is a12:// and a12s:// as a prefix which will involve the arcan-net tool to connect to a server. The second is with a @ or @host suffix, like mytag@. This will use keystore tags to find outbound connection parameters. These forms will also provide the fsrv vid access to a keystore capability. NOTES 1 The keystore access is currently the same as the one handed to the arcan process. This may be changed in the future. 2 If the forced target migration mode is used on a frameserver launched in an authoritative mode via define_avfeed or similar functions, the process tracking will be disabled and the kill 'guar- antee' on delete_image will be lost. EXAMPLE function target_devicehint0() target_alloc("devicehint", function(source, status) if (status.kind == "connected") then target_devicehint(source, "devicehint", true); -- send fallback path target_devicehint(source, 0); -- send rendernode end end); end targetcontrol August 2026 target_devicehint(3)
NAME | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLE
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=target_devicehint&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>