1 /* Copyright (C) 1993,94,95,96,97,98,99,2001 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Lesser General Public License for more details.
14 You should have received a copy of the GNU Lesser General Public
15 License along with the GNU C Library; if not, write to the Free
16 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
25 /* Get types, macros, constants and function declarations
26 for all Mach microkernel interaction. */
28 #include <mach/mig_errors.h>
30 /* Get types and constants necessary for Hurd interfaces. */
31 #include <hurd/hurd_types.h>
33 /* Get MiG stub declarations for commonly used Hurd interfaces. */
34 #include <hurd/auth.h>
35 #include <hurd/process.h>
39 /* Get `struct hurd_port' and related definitions implementing lightweight
40 user references for ports. These are used pervasively throughout the C
41 library; this is here to avoid putting it in nearly every source file. */
42 #include <hurd/port.h>
47 __hurd_fail (error_t err
)
51 case EMACH_SEND_INVALID_DEST
:
52 case EMIG_SERVER_DIED
:
53 /* The server has disappeared! */
60 case KERN_INVALID_ARGUMENT
:
73 /* Basic ports and info, initialized by startup. */
75 extern int _hurd_exec_flags
; /* Flags word passed in exec_startup. */
76 extern struct hurd_port
*_hurd_ports
;
77 extern unsigned int _hurd_nports
;
78 extern volatile mode_t _hurd_umask
;
79 extern sigset_t _hurdsig_traced
;
81 /* Shorthand macro for internal library code referencing _hurd_ports (see
84 #define __USEPORT(which, expr) \
85 HURD_PORT_USE (&_hurd_ports[INIT_PORT_##which], (expr))
87 /* Function version of __USEPORT: calls OPERATE with a send right. */
89 extern error_t
_hurd_ports_use (int which
, error_t (*operate
) (mach_port_t
));
92 /* Base address and size of the initial stack set up by the exec server.
93 If using cthreads, this stack is deallocated in startup.
96 extern vm_address_t _hurd_stack_base
;
97 extern vm_size_t _hurd_stack_size
;
99 /* Initial file descriptor table we were passed at startup. If we are
100 using a real dtable, these are turned into that and then cleared at
101 startup. If not, these are never changed after startup. Not locked. */
103 extern mach_port_t
*_hurd_init_dtable
;
104 extern mach_msg_type_number_t _hurd_init_dtablesize
;
106 /* Current process IDs. */
108 extern pid_t _hurd_pid
, _hurd_ppid
, _hurd_pgrp
;
109 extern int _hurd_orphaned
;
111 /* This variable is incremented every time the process IDs change. */
112 extern unsigned int _hurd_pids_changed_stamp
;
114 /* This condition is broadcast every time the process IDs change. */
115 extern struct condition _hurd_pids_changed_sync
;
117 /* Unix `data break', for brk and sbrk.
118 If brk and sbrk are not used, this info will not be initialized or used. */
121 /* Data break. This is what `sbrk (0)' returns. */
123 extern vm_address_t _hurd_brk
;
125 /* End of allocated space. This is generally `round_page (_hurd_brk)'. */
127 extern vm_address_t _hurd_data_end
;
129 /* This mutex locks _hurd_brk and _hurd_data_end. */
131 extern struct mutex _hurd_brk_lock
;
133 /* Set the data break to NEWBRK; _hurd_brk_lock must
134 be held, and is released on return. */
136 extern int _hurd_set_brk (vm_address_t newbrk
);
141 /* Calls to get and set basic ports. */
143 extern error_t
_hurd_ports_get (unsigned int which
, mach_port_t
*result
);
144 extern error_t
_hurd_ports_set (unsigned int which
, mach_port_t newport
);
146 extern process_t
getproc (void);
147 extern file_t
getcwdir (void), getcrdir (void);
148 extern auth_t
getauth (void);
149 extern mach_port_t
getcttyid (void);
150 extern int setproc (process_t
);
151 extern int setcwdir (file_t
), setcrdir (file_t
);
152 extern int setcttyid (mach_port_t
);
154 /* Does reauth with the proc server and fd io servers. */
155 extern int __setauth (auth_t
), setauth (auth_t
);
158 /* Modify a port cell by looking up a directory name.
159 This verifies that it is a directory and that we have search permission. */
160 extern int _hurd_change_directory_port_from_name (struct hurd_port
*portcell
,
162 /* Same thing, but using an open file descriptor.
163 Also verifies that it is a directory and that we have search permission. */
164 extern int _hurd_change_directory_port_from_fd (struct hurd_port
*portcell
,
169 /* Get and set the effective UID set. */
170 extern int geteuids (int __n
, uid_t
*__uidset
);
171 extern int seteuids (int __n
, const uid_t
*__uidset
);
174 /* Split FILE into a directory and a name within the directory. The
175 directory lookup uses the current root and working directory. If
176 successful, stores in *NAME a pointer into FILE where the name
177 within directory begins and returns a port to the directory;
178 otherwise sets `errno' and returns MACH_PORT_NULL. */
180 extern file_t
__file_name_split (const char *file
, char **name
);
181 extern file_t
file_name_split (const char *file
, char **name
);
183 /* Split DIRECTORY into a parent directory and a name within the directory.
184 This is the same as file_name_split, but ignores trailing slashes. */
186 extern file_t
__directory_name_split (const char *file
, char **name
);
187 extern file_t
directory_name_split (const char *file
, char **name
);
189 /* Open a port to FILE with the given FLAGS and MODE (see <fcntl.h>).
190 The file lookup uses the current root and working directory.
191 Returns a port to the file if successful; otherwise sets `errno'
192 and returns MACH_PORT_NULL. */
194 extern file_t
__file_name_lookup (const char *file
, int flags
, mode_t mode
);
195 extern file_t
file_name_lookup (const char *file
, int flags
, mode_t mode
);
197 /* Open a port to FILE with the given FLAGS and MODE (see <fcntl.h>). The
198 file lookup uses the current root directory, but uses STARTDIR as the
199 "working directory" for file relative names. Returns a port to the file
200 if successful; otherwise sets `errno' and returns MACH_PORT_NULL. */
202 extern file_t
__file_name_lookup_under (file_t startdir
, const char *file
,
203 int flags
, mode_t mode
);
204 extern file_t
file_name_lookup_under (file_t startdir
, const char *file
,
205 int flags
, mode_t mode
);
208 /* Lookup FILE_NAME and return the node opened with FLAGS & MODE
209 (see hurd_file_name_lookup for details), but a simple file name (without
210 any directory prefixes) will be consecutively prefixed with the pathnames
211 in the `:' separated list PATH until one succeeds in a successful lookup.
212 If none succeed, then the first error that wasn't ENOENT is returned, or
213 ENOENT if no other errors were returned. If PREFIXED_NAME is non-NULL,
214 then if the result is looked up directly, *PREFIXED_NAME is set to NULL, and
215 if it is looked up using a prefix from PATH, *PREFIXED_NAME is set to
216 malloc'd storage containing the prefixed name. */
217 extern file_t
file_name_path_lookup (const char *file_name
, const char *path
,
218 int flags
, mode_t mode
,
219 char **prefixed_name
);
223 /* Open a file descriptor on a port. FLAGS are as for `open'; flags
224 affected by io_set_openmodes are not changed by this. If successful,
225 this consumes a user reference for PORT (which will be deallocated on
228 extern int openport (io_t port
, int flags
);
230 /* Open a stream on a port. MODE is as for `fopen'.
231 If successful, this consumes a user reference for PORT
232 (which will be deallocated on fclose). */
234 extern FILE *fopenport (io_t port
, const char *mode
);
235 extern FILE *__fopenport (io_t port
, const char *mode
);
238 /* Execute a file, replacing TASK's current program image. */
240 extern error_t
_hurd_exec (task_t task
,
246 /* Inform the proc server we have exited with STATUS, and kill the
247 task thoroughly. This function never returns, no matter what. */
249 extern void _hurd_exit (int status
) __attribute__ ((noreturn
));
252 /* Initialize the library data structures from the
253 ints and ports passed to us by the exec server.
254 Then vm_deallocate PORTARRAY and INTARRAY. */
256 extern void _hurd_init (int flags
, char **argv
,
257 mach_port_t
*portarray
, size_t portarraysize
,
258 int *intarray
, size_t intarraysize
);
260 /* Do startup handshaking with the proc server, and initialize library data
261 structures that require proc server interaction. This includes
262 initializing signals; see _hurdsig_init in <hurd/signal.h>. */
264 extern void _hurd_proc_init (char **argv
,
265 const int *intarray
, size_t intarraysize
);
268 /* Return the socket server for sockaddr domain DOMAIN. If DEAD is
269 nonzero, remove the old cached port and always do a fresh lookup.
271 It is assumed that a socket server will stay alive during a complex socket
272 operation involving several RPCs. But a socket server may die during
273 long idle periods between socket operations. Callers should first pass
274 zero for DEAD; if the first socket RPC tried on the returned port fails
275 with MACH_SEND_INVALID_DEST or MIG_SERVER_DIED (indicating the server
276 went away), the caller should call _hurd_socket_server again with DEAD
277 nonzero and retry the RPC on the new socket server port. */
279 extern socket_t
_hurd_socket_server (int domain
, int dead
);
281 /* Send a `sig_post' RPC to process number PID. If PID is zero,
282 send the message to all processes in the current process's process group.
283 If PID is < -1, send SIG to all processes in process group - PID.
284 SIG and REFPORT are passed along in the request message. */
286 extern error_t
_hurd_sig_post (pid_t pid
, int sig
, mach_port_t refport
);
287 extern error_t
hurd_sig_post (pid_t pid
, int sig
, mach_port_t refport
);
289 /* Fetch the host privileged port and device master port from the proc
290 server. They are fetched only once and then cached in the
291 variables below. A special program that gets them from somewhere
292 other than the proc server (such as a bootstrap filesystem) can set
293 these variables to install the ports. */
295 extern kern_return_t
__get_privileged_ports (host_priv_t
*host_priv_ptr
,
296 device_t
*device_master_ptr
);
297 extern kern_return_t
get_privileged_ports (host_priv_t
*host_priv_ptr
,
298 device_t
*device_master_ptr
);
299 extern mach_port_t _hurd_host_priv
, _hurd_device_master
;
301 /* Return the PID of the task whose control port is TASK.
302 On error, sets `errno' and returns -1. */
304 extern pid_t
__task2pid (task_t task
), task2pid (task_t task
);
306 /* Return the task control port of process PID.
307 On error, sets `errno' and returns MACH_PORT_NULL. */
309 extern task_t
__pid2task (pid_t pid
), pid2task (pid_t pid
);
311 /* Return the current thread's thread port. This is a cheap operation (no
312 system call), but it relies on Hurd signal state being set up. */
313 extern thread_t
hurd_thread_self (void);
316 /* Cancel pending operations on THREAD. If it is doing an interruptible RPC,
317 that RPC will now return EINTR; otherwise, the "cancelled" flag will be
318 set, causing the next `hurd_check_cancel' call to return nonzero or the
319 next interruptible RPC to return EINTR (whichever is called first). */
320 extern error_t
hurd_thread_cancel (thread_t thread
);
322 /* Test and clear the calling thread's "cancelled" flag. */
323 extern int hurd_check_cancel (void);
326 /* Return the io server port for file descriptor FD.
327 This adds a Mach user reference to the returned port.
328 On error, sets `errno' and returns MACH_PORT_NULL. */
330 extern io_t
__getdport (int fd
), getdport (int fd
);
335 /* Write formatted output to PORT, a Mach port supporting the i/o protocol,
336 according to the format string FORMAT, using the argument list in ARG. */
337 int vpprintf (io_t port
, const char *format
, va_list arg
);