Virtual Method

FoundryAcpClientcreate_terminal

unstable since: 1.2

Declaration [src]

DexFuture*
create_terminal (
  FoundryAcpClient* self,
  FoundryAcpSession* session,
  const char* command,
  const char* const* argv,
  const char* cwd,
  const char* const* environ,
  gssize output_byte_limit
)

Description [src]

Handles an ACP terminal/create request.

The returned future must resolve to a FoundryAcpTerminal.

Available since: 1.2

Parameters

session

Type: FoundryAcpSession

A FoundryAcpSession.

The data is owned by the caller of the method.
command

Type: const char*

The command to execute.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
argv

Type: An array of char*

Command arguments.

The argument can be NULL.
The array must be NULL-terminated.
The data is owned by the caller of the method.
Each element is a NUL terminated UTF-8 string.
cwd

Type: const char*

Working directory.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
environ

Type: An array of char*

Environment.

The argument can be NULL.
The array must be NULL-terminated.
The data is owned by the caller of the method.
Each element is a NUL terminated UTF-8 string.
output_byte_limit

Type: gssize

Output byte limit, or -1 for default.

Return value

Type: DexFuture

A DexFuture.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.