Unix/Linux Go Back    


Linux 2.6 - man page for people (linux section 2)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


people(2)										people(2)

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

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 pgrp_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/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... */
	 }
       }

AUTHOR
       This man page was written by Ingvar Mattsson, as a contribution to the a.s.r man page col-
       lection.

4th Berkeley Distribution		Release 0.01 alpha				people(2)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:05 PM.