efs_closeKS Subroutine

Purpose

Disassociates the processes with open keystores.

Library

EFS Library (libefs.a)

Syntax

#include <libefs.h>

int efs_closeKS(void)

Description

The efs_closeKS subroutine disassociates an open keystore with a process. Therefore, the process does not have access to the EFS keys and is not to encrypt or decrypt files. Opening an encrypted file produces the error ENOATTR.

If a keystore is open using the efskeymgr command or using the login process, the keys within the keystore are associated to user’s process and child processes. These keys are used within an Encrypted File System (EFS) to encrypt and decrypt files. If the efs_closeKS subroutine is called, the process is disassociated with the keystores, and is no longer able to open, decrypt or read EFS files. The process is not be able to open, encrypt or write EFS files. If the process has previously opened EFS files, those file operations maintain the ability to encrypt and decrypt.

Return Values

If successful, the efs_closeKS subroutine returns a value of zero. If it fails, it returns a value of -1 and sets the errno error code.

Errors

No error code is defined.

Files

The/etc/security/group File and the user File in Files Reference.