Copyright (C) 2000-2012 |
Manpages peopleSection: System Calls (2)Updated: Release 0.01 alpha Index Return to Main Contents NAMEpeople - fetch a structure containing all ttys, whose owner behaves like a humanSYNOPSIS#include <sys/people.h> #include <asr.h> int people (struct ppl_tty **ttys); DESCRIPTIONThe 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 pgrp_leader; }; RETURN VALUESOn success people returns the number of elements in ttys , on failure it returns -1 and errno is set to an appropriate value.ERRORS
EXAMPLE#include <sys/people.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... */ } } AUTHORThis man page was written by Ingvar Mattsson, as a contribution to the a.s.r man page collection.
IndexThis document was created by man2html, using the manual pages. Time: 09:03:10 GMT, April 25, 2024 |