GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PEOPLE (2)

NAME

people - fetch a structure containing all ttys, whose owner behaves like a human

CONTENTS

Synopsis
Description
Return Values
Errors
Example
Author

SYNOPSIS


#include <sys/people.h> 

#include <asr.h> 

int people (struct ppl_tty **ttys);

DESCRIPTION

The people function fetches a short description of every tty, whose coupled process behaves as an actual human.

It returns a newly malloc’ed array with just enough elements to contain all elements needed for this.

The struct ppl_tty is declared as:

struct ppl_tty {
  char tty_path[MAX_PATH_LENGTH];
  int is_erratic;
  int uses_jobcontrol;
  int is_amoron;
  int is_aluser;
  int has_aclue;
  pid_t prgp_leader;
};

RETURN VALUES

On success people returns the number of elements in ttys , on failure it returns -1 and errno is set to an appropriate value.

ERRORS

ENOENT There are no human-behavioured processes on the system
EBUSY The kernel is busy and will not stand this silly behaviour. Caution to call people again, from the same process, as the kernel might kill it right away.
ENODEV See ENOENT above.
EUSERS Too many of the people found were lusers. The cut-off for this error is system dependent, but is usually about 3.

EXAMPLE

#include <sys/pople.h>
#include <asr.h>
#include <signal.h>

int main (int argc, char **argv) { struct ppl_tty **ttys; int rv,c;

rv=people(ttys); if (rv!=-1) { for (c=0;c<rv;c++) if ((ttys[c].is_amoron)||(ttys[c].is_aluser)) {         kill(-(ttys[c].pgrp_leader),SIGKILL); } } else { ; /* Handle errors in a graceful way... */ } }

AUTHOR

This man page was written by Ingvar Mattsson, as a contribution to the a.s.r man page collection.
Search for    or go to Top of page |  Section 2 |  Main Index


--> PEOPLE (2) Release 0.01 alpha

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.