From 1c67869e4a93694630bf3982eba131a980eeb950 Mon Sep 17 00:00:00 2001 From: Miles Bader Date: Fri, 10 Nov 1995 15:02:41 +0000 Subject: Initial revision --- hurd/process_request.defs | 381 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 381 insertions(+) create mode 100644 hurd/process_request.defs diff --git a/hurd/process_request.defs b/hurd/process_request.defs new file mode 100644 index 00000000..38d05f72 --- /dev/null +++ b/hurd/process_request.defs @@ -0,0 +1,381 @@ +/* Definitions for process server interface (request-only version) + + Copyright (C) 1992, 1993, 1994, 1995 Free Software Foundation, Inc. + +This file is part of the GNU Hurd. + +The GNU Hurd is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +The GNU Hurd is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with the GNU Hurd; see the file COPYING. If not, write to +the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ + +subsystem process 24000; + +#include + +#ifdef PROCESS_IMPORTS +PROCESS_IMPORTS +#endif + +type reply_port_t = MACH_MSG_TYPE_MAKE_SEND_ONCE | polymorphic + ctype: mach_port_t; + + +/*** Host management ***/ + +/* Set the hostid for the machine. This should be unique among all + machines. By convention, it is the "primary" IP address of the + machine. */ +simpleroutine proc_sethostid_request ( + process: process_t; + ureplyport reply: reply_port_t; + hostid: int); + +/* Get the host id. */ +simpleroutine proc_gethostid_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Set the hostname for the machine. By convention this is the DNS + FQDN for the machine. */ +simpleroutine proc_sethostname_request ( + process: process_t; + ureplyport reply: reply_port_t; + hostname: data_t); + +/* Get the hostname. */ +simpleroutine proc_gethostname_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Get the privileged host port and the device master port. */ +simpleroutine proc_getprivports_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Return all the pids of all live processes. */ +simpleroutine proc_getallpids_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Set the "standard exec data", used by programs that want predefined + values for exec. */ +simpleroutine proc_setexecdata_request ( + process: process_t; + ureplyport reply: reply_port_t; + ports: portarray_t; + ints: intarray_t); + +/* Get the standard exec data */ +simpleroutine proc_getexecdata_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Request notification with exec_setexecdata on NOTIFY. */ +simpleroutine proc_execdata_notify_request ( + process: process_t; + ureplyport reply: reply_port_t; + notify: mach_port_send_t); + +/* Return a uname structure for the currently running system. */ +simpleroutine proc_uname_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Tell the server who we are for inclusion in the uname string. */ +simpleroutine proc_register_version_request ( + process: process_t; + ureplyport reply: reply_port_t; + credential: host_priv_t; + name: string_t; + release: string_t; + version: string_t); + +/*** Process creation and simple management. ***/ + +/* There is a 1-1 relationship between tasks and processes; to create + a new process, just create a new task and use proc_task2proc. */ + +/* Change the current authentication of the process. The user should + follow this call with a call to auth_user_authenticate. The + new_port passed back through the auth server will be + MACH_PORT_NULL. */ +simpleroutine proc_reauthenticate_request ( + process: process_t; + ureplyport reply: reply_port_t; + rendezvous2: mach_port_send_t); + +/* Declare that a task is a child of the caller. The task's state + will then inherit from the caller. This call can be made only once + per task. */ +simpleroutine proc_child_request ( + process: process_t; + ureplyport reply: reply_port_t; + child: task_t); + +/* Atomically change the message port of a process. */ +simpleroutine proc_setmsgport_request ( + process: process_t; + replyport reply: reply_port_t; + newmsgport: mach_port_t); + +/* Cause a task to take over the pid and all other state from an + existing task, and kill the old task with task_terminate. The + message port will be set to MACH_PORT_NULL. This is principally + used for doing exec's with the EXEC_NEWTASK bit set. The request + port assigned to NEWTASK does not change. The new task cannot have + had proc_child called on its behalf, it cannot have a pgrp, a session, + a login name set with proc_setlogin, it cannot have called proc_child, + and it cannot have a message port. */ +/* If this call is made for a process which is no longer alive or + does not exist, then newtask will be killed (and no error + is returned). */ +simpleroutine proc_reassign_request ( + process: process_t; + ureplyport reply: reply_port_t; + newtask: task_t); + +/* Set the owner of the process. The new owner must be within the + current authentication of the caller. */ +simpleroutine proc_setowner_request ( + process: process_t; + ureplyport reply: reply_port_t; + owner: uid_t); + +/* Get the process ID and the parent process ID, also find out if we + are orphaned. */ +simpleroutine proc_getpids_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Set the locations of ARGV and ENVP which will be examined + by proc_getprocargs and proc_getprocenv. */ +simpleroutine proc_set_arg_locations_request ( + process: process_t; + ureplyport reply: reply_port_t; + argv: vm_address_t; + envp: vm_address_t); + +/* Fetch the locations set by proc_set_arg_locations. */ +simpleroutine proc_get_arg_locations_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Fetch the message port of a process */ +simpleroutine proc_getmsgport_request ( + process: process_t; + replyport reply: reply_port_t; + pid: pid_t); + +/* Wait for a child process to exit. If pid is zero, it waits for any + child in the same pgrp as the parent. If pid is -1, it waits for + any child. Otherwise, if pid is negative, it waits for any process + in the specified process group. If pid is positive, it waits for + the specified process. The exit status and resource usage of the + process are returned in status and rusage respectively. */ +simpleroutine proc_wait_request ( + process: process_t; + replyport reply: reply_port_t; + pid: pid_t; + options: int); + +/* Have the process server stop all threads except contthread. */ +simpleroutine proc_dostop_request ( + process: process_t; + ureplyport reply: reply_port_t; + contthread: thread_t); + +/* Take over exception messages received on MSGPORT. Any exception + messages received will be forwarded to FORWARDPORT. In addition, + the thread causing the exception will be aborted (with thread_abort) + and have its state adjusted (as by thread_set_state). */ +simpleroutine proc_handle_exceptions_request ( + process: process_t; + ureplyport reply: reply_port_t; + msgport: mach_port_move_receive_t; + forwardport: mach_port_send_t; + flavor: int; + new_state: thread_state_t); + + + +/*** Mark bits. Some of these (exec, traced, eg) modify small pieces + of the proc server's behavior; others are purely informational. ***/ + +/* Mark the process as stopped on a signal. */ +simpleroutine proc_mark_stop_request ( + process: process_t; + ureplyport reply: reply_port_t; + signo: int); + +/* Mark the process as continued after a stop. */ +simpleroutine proc_mark_cont_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Tell the process server that the process is going away. If it dies + without calling this, it will look to the parent like the process + died with SIGKILL. This call allows for a cleaner exit. */ +simpleroutine proc_mark_exit_request ( + process: process_t; + ureplyport reply: reply_port_t; + status: int); + +/* Inform the process server that the process has completed an exec. */ +simpleroutine proc_mark_exec_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Inform the process server that the process has asked to be traced. + The only result of this is to change the behavior of wait by the + parent slightly. */ +simpleroutine proc_mark_traced_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Inform the process server whether SIGCHLD should be sent for stopped + child processes. */ +simpleroutine proc_mod_stopchild_request ( + process: process_t; + ureplyport reply: reply_port_t; + doit: int); + + +/*** Miscellaneous process information queries. ***/ + +simpleroutine proc_pid2task_request ( + process: process_t; + ureplyport reply: reply_port_t; + pid: pid_t); + +simpleroutine proc_task2pid_request ( + process: process_t; + ureplyport reply: reply_port_t; + task: task_t); + +/* Return the procserver port for the specified task. */ +simpleroutine proc_task2proc_request ( + process: process_t; + ureplyport reply: reply_port_t; + task: task_t); + +simpleroutine proc_proc2task_request ( + process: process_t; + ureplyport reply: reply_port_t); + +simpleroutine proc_pid2proc_request ( + process: process_t; + ureplyport reply: reply_port_t; + pid: pid_t); + +simpleroutine proc_getprocinfo_request ( + process: process_t; + ureplyport reply: reply_port_t; + which: pid_t; + flags: int); + +simpleroutine proc_getprocargs_request ( + process: process_t; + ureplyport reply: reply_port_t; + which: pid_t); + +simpleroutine proc_getprocenv_request ( + process: process_t; + ureplyport reply: reply_port_t; + which: pid_t); + +/* Create a new login collection. The pid of PROCESS will be the id + of the collection. All the children (and their children, and so forth) of + PROCESS will automatically join the collection. If PROCESS dies its + children (and their children, and so forth) will become part of init's + process collection. */ +simpleroutine proc_make_login_coll_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Get the process collection ID for the process specified by pid. */ +simpleroutine proc_getloginid_request ( + process: process_t; + ureplyport reply: reply_port_t; + pid: pid_t); + +/* Get the pids of all the members of process collection ID. */ +simpleroutine proc_getloginpids_request ( + process: process_t; + ureplyport reply: reply_port_t; + id: pid_t); + +/* These next two should not actually be used; they are here + for "historic reasons." You are not expected to understand this. */ +simpleroutine proc_setlogin_request ( + process: process_t; + ureplyport reply: reply_port_t; + logname: string_t); + +simpleroutine proc_getlogin_request ( + process: process_t; + ureplyport reply: reply_port_t); + + +/*** Sessions and process groups. ***/ + +/* Create a new session. The process's pgrp is set to its pid, and + becomes the session leader. */ +simpleroutine proc_setsid_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Return the pid of a process's session leader. */ +simpleroutine proc_getsid_request ( + process: process_t; + ureplyport reply: reply_port_t; + pid: pid_t); + +/* Get the pgids of all the members of a session. */ +simpleroutine proc_getsessionpgids_request ( + process: process_t; + ureplyport reply: reply_port_t; + sid: pid_t); + +/* Get the pids of all the members of a session. */ +simpleroutine proc_getsessionpids_request ( + process: process_t; + ureplyport reply: reply_port_t; + sid: pid_t); + +/* Return a "session ID" port for the session of the caller. + This port is generally only available to members of the session. + (It has no listener, but is useful for identification purposes.) */ +simpleroutine proc_getsidport_request ( + process: process_t; + ureplyport reply: reply_port_t); + +/* Set the process group of a process. */ +simpleroutine proc_setpgrp_request ( + process: process_t; + ureplyport reply: reply_port_t; + pid: pid_t; + pgrp: pid_t); + +/* Get the process group of a process. */ +simpleroutine proc_getpgrp_request ( + process: process_t; + ureplyport reply: reply_port_t; + pid: pid_t); + +/* Get the pids of all the members of a pgrp. */ +simpleroutine proc_getpgrppids_request ( + process: process_t; + ureplyport reply: reply_port_t; + pgrp: pid_t); + + -- cgit v1.2.3