optionRestore(3) Programmer's Manual optionRestore(3)

# [NAME](#NAME)

optionRestore - restore option state from memory copy

# [SYNOPSIS](#SYNOPSIS)

#include <*your-opts.h*>  
cc \[...] -o outfile infile.c -l**opts** \[...]

void **optionRestore**(tOptions * *pOpts*);

# [DESCRIPTION](#DESCRIPTION)

Copy back the option state from saved memory. The allocated memory is left intact, so this routine can be called repeatedly without having to call optionSaveState again. If you are restoring a state that was saved before the first call to [optionProcess(3AO)](/man/enterprise-packages/autogen/optionProcess.3AO), then you may change the contents of the argc/argv parameters to optionProcess.

[*pOpts*](#pOpts)

program options descriptor

# [ERRORS](#ERRORS)

If you have not called **optionSaveState** before, a diagnostic is printed to **stderr** and exit is called.

# [SEE ALSO](#SEE_ALSO)

The *info* documentation for the -l*opts* library.  
[ao\_string\_tokenize(3)](/man/enterprise-packages/autogen/ao_string_tokenize.3), [configFileLoad(3)](/man/enterprise-packages/autogen/configFileLoad.3), [optionFileLoad(3)](/man/enterprise-packages/autogen/optionFileLoad.3), [optionFindNextValue(3)](/man/enterprise-packages/autogen/optionFindNextValue.3), [optionFindValue(3)](/man/enterprise-packages/autogen/optionFindValue.3), [optionFree(3)](/man/enterprise-packages/autogen/optionFree.3), [optionGetValue(3)](/man/enterprise-packages/autogen/optionGetValue.3), [optionLoadLine(3)](/man/enterprise-packages/autogen/optionLoadLine.3), [optionMemberList(3)](/man/enterprise-packages/autogen/optionMemberList.3), [optionNextValue(3)](/man/enterprise-packages/autogen/optionNextValue.3), [optionOnlyUsage(3)](/man/enterprise-packages/autogen/optionOnlyUsage.3), [optionPrintVersion(3)](/man/enterprise-packages/autogen/optionPrintVersion.3), [optionPrintVersionAndReturn(3)](/man/enterprise-packages/autogen/optionPrintVersionAndReturn.3), [optionProcess(3)](/man/enterprise-packages/autogen/optionProcess.3), [optionSaveFile(3)](/man/enterprise-packages/autogen/optionSaveFile.3), [optionSaveState(3)](/man/enterprise-packages/autogen/optionSaveState.3), [optionUnloadNested(3)](/man/enterprise-packages/autogen/optionUnloadNested.3), [optionVersion(3)](/man/enterprise-packages/autogen/optionVersion.3), [strequate(3)](/man/enterprise-packages/autogen/strequate.3), [streqvcmp(3)](/man/enterprise-packages/autogen/streqvcmp.3), [streqvmap(3)](/man/enterprise-packages/autogen/streqvmap.3), [strneqvcmp(3)](/man/enterprise-packages/autogen/strneqvcmp.3), [strtransform(3)](/man/enterprise-packages/autogen/strtransform.3),

2026-10-31

---

Document: optionRestore(3) from autogen 5.18.16-r6 (Chainguard OS)
Source: https://git.savannah.gnu.org/git/autogen.git