onload_stack_opt_set_str - UG1586

Onload User Guide (UG1586)

Document ID
UG1586
Release Date
2025-11-03
Revision
1.31 English

Description

Set/modify per-stack options for all subsequently created stacks. These override any global per-stack environment options already set. When using this function, check the scope field on the environment variable, for example:

EF_NAME

Default: none

Maximum: 8 chars

Scope: per-stack

Definition

int onload_stack_opt_set_str(const char* name, char* value)

Formal Parameters

name
Stack option to modify.
value
New value for the stack option.

Example

onload_stack_opt_set_str(“EF_NAME”, "trader1");

Return Value

0 on success.

errno set to EINVAL if the requested option is not found or ENOMEM.

Notes

  • Cannot be used to modify options on existing stacks - only for new stacks.
  • Cannot be used to modify per-process options - only per-stack options.
  • Modified options will be used for all newly created stacks until onload_stack_opt_reset() is called.