2004-11-03 13:51:07 +00:00
|
|
|
.\" Hey Emacs! This file is -*- nroff -*- source.
|
|
|
|
.\"
|
|
|
|
.\" Copyright (C) 2003 Andi Kleen
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to make and distribute verbatim copies of this
|
|
|
|
.\" manual provided the copyright notice and this permission notice are
|
|
|
|
.\" preserved on all copies.
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to copy and distribute modified versions of this
|
|
|
|
.\" manual under the conditions for verbatim copying, provided that the
|
|
|
|
.\" entire resulting derived work is distributed under the terms of a
|
|
|
|
.\" permission notice identical to this one.
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Since the Linux kernel and libraries are constantly changing, this
|
|
|
|
.\" manual page may be incorrect or out-of-date. The author(s) assume no
|
|
|
|
.\" responsibility for errors or omissions, or for damages resulting from
|
|
|
|
.\" the use of the information contained herein. The author(s) may not
|
|
|
|
.\" have taken the same level of care in the production of this manual,
|
|
|
|
.\" which is licensed free of charge, as they might when working
|
|
|
|
.\" professionally.
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
|
|
|
.\" the source, must acknowledge the copyright and authors of this work.
|
2007-05-30 05:36:26 +00:00
|
|
|
.TH ARCH_PRCTL 2 2003-02-02 "Linux" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
|
|
|
arch_prctl \- set architecture specific thread state
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B #include <asm/prctl.h>
|
2007-07-02 20:06:14 +00:00
|
|
|
.br
|
2004-11-03 13:51:07 +00:00
|
|
|
.B #include <sys/prctl.h>
|
|
|
|
.sp
|
2007-07-10 04:51:30 +00:00
|
|
|
.BI "int arch_prctl(int " code ", unsigned long " addr );
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR arch_prctl ()
|
2004-11-03 13:51:07 +00:00
|
|
|
function sets architecture specific process or thread state.
|
|
|
|
.I code
|
|
|
|
selects a subfunction
|
|
|
|
and passes argument
|
2007-04-12 22:42:49 +00:00
|
|
|
.I addr
|
|
|
|
to it.
|
2004-11-03 13:51:07 +00:00
|
|
|
.LP
|
|
|
|
Sub functions for x86-64 are:
|
|
|
|
.TP
|
|
|
|
.B ARCH_SET_FS
|
2007-06-25 09:55:58 +00:00
|
|
|
Set the 64-bit base for the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I FS
|
|
|
|
register to
|
|
|
|
.IR addr .
|
|
|
|
.TP
|
|
|
|
.B ARCH_GET_FS
|
2007-06-25 09:55:58 +00:00
|
|
|
Return the 64-bit base value for the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I FS
|
2007-04-12 22:42:49 +00:00
|
|
|
register of the current thread in the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I unsigned long
|
2007-04-12 22:42:49 +00:00
|
|
|
pointed to by the
|
|
|
|
.I address
|
2004-11-03 13:51:07 +00:00
|
|
|
parameter
|
|
|
|
.TP
|
|
|
|
.B ARCH_SET_GS
|
2007-06-25 09:55:58 +00:00
|
|
|
Set the 64-bit base for the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I GS
|
|
|
|
register to
|
|
|
|
.IR addr .
|
|
|
|
.TP
|
|
|
|
.B ARCH_GET_GS
|
2007-06-25 09:55:58 +00:00
|
|
|
Return the 64-bit base value for the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I GS
|
2007-04-12 22:42:49 +00:00
|
|
|
register of the current thread in the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I unsigned long
|
2007-04-12 22:42:49 +00:00
|
|
|
pointed to by the
|
|
|
|
.I address
|
2004-11-03 13:51:07 +00:00
|
|
|
parameter.
|
2007-05-26 07:34:05 +00:00
|
|
|
.SH RETURN VALUE
|
|
|
|
On sucess,
|
|
|
|
.BR arch_prctl ()
|
|
|
|
returns 0; on error, \-1 is returned, and
|
|
|
|
.I errno
|
|
|
|
is set to indicate the error.
|
2007-05-18 16:06:42 +00:00
|
|
|
.SH ERRORS
|
|
|
|
.TP
|
|
|
|
.B EFAULT
|
|
|
|
.I addr
|
|
|
|
points to an unmapped address or is outside the process address space.
|
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
.I code
|
|
|
|
is not a valid subcommand.
|
|
|
|
.TP
|
|
|
|
.B EPERM
|
|
|
|
.I addr
|
|
|
|
is outside the process address space.
|
|
|
|
.\" .SH AUTHOR
|
|
|
|
.\" Man page written by Andi Kleen.
|
|
|
|
.SH "CONFORMING TO"
|
|
|
|
.BR arch_prctl ()
|
|
|
|
is a Linux/x86-64 extension and should not be used in programs intended
|
|
|
|
to be portable.
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NOTES
|
2005-11-02 11:34:24 +00:00
|
|
|
.BR arch_prctl ()
|
2007-06-25 09:55:58 +00:00
|
|
|
is only supported on Linux/x86-64 for 64-bit programs currently.
|
2004-11-03 13:51:07 +00:00
|
|
|
|
2007-06-25 09:55:58 +00:00
|
|
|
The 64-bit base changes when a new 32-bit segment selector is loaded.
|
2004-11-03 13:51:07 +00:00
|
|
|
|
|
|
|
.B ARCH_SET_GS
|
|
|
|
is disabled in some kernels.
|
|
|
|
|
2007-06-25 09:55:58 +00:00
|
|
|
Context switches for 64-bit segment bases are rather expensive.
|
|
|
|
It may be a faster alternative to set a 32-bit base using a
|
|
|
|
segment selector by setting up an LDT with
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR modify_ldt (2)
|
2007-04-12 22:42:49 +00:00
|
|
|
or using the
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR set_thread_area (2)
|
2007-04-12 22:42:49 +00:00
|
|
|
system call in a 2.5 kernel.
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR arch_prctl ()
|
2004-11-03 13:51:07 +00:00
|
|
|
is only needed when you want to set bases that are larger than 4GB.
|
|
|
|
Memory in the first 2GB of address space can be allocated by using
|
|
|
|
.BR mmap (2)
|
|
|
|
with the
|
2007-06-18 19:56:51 +00:00
|
|
|
.B MAP_32BIT
|
2004-11-03 13:51:07 +00:00
|
|
|
flag.
|
|
|
|
|
2005-11-03 14:14:09 +00:00
|
|
|
As of version 2.3.5, glibc provides no prototype for
|
|
|
|
.BR arch_prctl ().
|
|
|
|
You have to declare it yourself for now.
|
|
|
|
This may be fixed in future glibc versions.
|
2004-11-03 13:51:07 +00:00
|
|
|
|
2007-04-12 22:42:49 +00:00
|
|
|
.I FS
|
2004-11-03 13:51:07 +00:00
|
|
|
may be already used by the threading library.
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR mmap (2),
|
|
|
|
.BR modify_ldt (2),
|
|
|
|
.BR prctl (2),
|
|
|
|
.BR set_thread_area (2)
|
|
|
|
.sp
|
|
|
|
AMD X86-64 Programmer's manual
|