screen_set_session_property_cv()

Set the value of the specified session property of type char

Synopsis:

#include <screen/screen.h>
int screen_set_session_property_cv(screen_session_t ssn,
                                   int pname,
                                   int len,
                                   const char *param)

Arguments:

ssn
The handle of the session whose property is being set.
pname
The name of the property whose value is being set. The properties that you can set are of type Screen property types.
len
The size (that includes a terminating null character) of param. Screen reads from param until it encounters a null character (\0), or until len number of bytes is reached. Ensure that len doesn't exceed the maximum size that Screen allows for the property specified by pname.
param
A pointer to a character array containing the new property value. This array must have a minimum length of len.

Library:

libscreen

Description:

Function Type: Delayed Execution

This function sets the value of a session property from a user-provided buffer. You can use this function to set the value of the following properties:

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).