Return to kill.c CVS log

Up to [OS/2 SDKs] / os2sdk / demos / examples / kill

Annotation of os2sdk/demos/examples/kill/kill.c, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Example of DOSKILLPROCESS usage.
                      3:  *
                      4:  * With DOSKILLPROCESS, any process can kill any other.  While this is a
                      5:  * powerful and versatile ability, problems can be created if a process
                      6:  * kills, say, the session manager or a copy of CMD.
                      7:  * 
                      8:  * Another danger to watch out for is that not all resources are freed
                      9:  * when a process is killed.  If the process owned any RAM semaphores
                     10:  * when it was killed, the semaphores will not be automatically freed.
                     11:  * This sometimes makes it dangerous to kill a process without knowing
                     12:  * what state the intended victim is in.  DOSKILLPROCESS is best thought
                     13:  * of, then, as a last ditch effort to get rid of an unwieldy process.
                     14:  * 
                     15:  * DOSKILLPROCESS does not actually kill the process but instead sends
                     16:  * it a termination signal.  It is possible for processes to protect
                     17:  * themselves against such signals, and once the target is in EXITLIST
                     18:  * processing, further calls to DOSKILLPROCESS have no effect
                     19:  * whatsoever.
                     20:  *
                     21:  * Invoke as "kill pid", where pid is the process id to receive the
                     22:  * kill signal. This program works protected mode only.
                     23:  *
                     24:  * To observe the operation of this program, use the "sleep" example
                     25:  * and detach it in the background. Then use kill to kill the sleep
                     26:  * program. The detach command tells you the pid of the background
                     27:  * process.
                     28:  *
                     29:  * Compile as: cl -AL -Lp -G2 kill.c
                     30:  *
                     31:  * Copyright (C) Microsoft Corp. 1986
                     32:  */
                     33: 
                     34: #include <stdio.h>
                     35: #include <doscalls.h>
                     36: 
                     37: main(argc, argv)
                     38: int argc;
                     39: char *argv[];
                     40: {
                     41:        unsigned pid;
                     42:        unsigned kill_opt = 1;
                     43:        
                     44:        /* get the process to kill from the command line */
                     45:        if(argc == 2) {
                     46:                pid = atoi(argv[1]);
                     47:        
                     48:                /* kill the process, but not its child processes */
                     49:                if(DOSKILLPROCESS(kill_opt, pid) != 0)
                     50:                        printf("Unable to kill process %u\n", pid);
                     51:        }
                     52: }

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.