System Grab Bag

View all man pages from Linux (or from all projects)

Name

vhangup - virtually hangup the current terminal

Library

Standard C library ( libc ", " -lc )

Synopsis

#include <unistd.h> 
int vhangup(void); 

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

vhangup()

    Since glibc 2.21:
        _DEFAULT_SOURCE
    In glibc 2.19 and 2.20:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    Up to and including glibc 2.19:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

Description

vhangup() simulates a hangup on the current terminal. This call arranges for other users to have a \*(lqclean\*(rq terminal at login time.

Return Value

On success, zero is returned. On error, -1 is returned, and errno is set to indicate the error.

Errors

EPERM The calling process has insufficient privilege to call vhangup() the CAP_SYS_TTY_CONFIG capability is required.

Standards

Linux.

See Also

  1. init(1),
  2. capabilities(7)