Date: Tue, 8 Mar 2016 11:30:04 +0100
From: Ingo Molnar <mingo@kernel.org>
To: "H. Peter Anvin" <hpa@zytor.com>
Cc: Andy Lutomirski <luto@kernel.org>, x86@kernel.org,
        linux-kernel@vger.kernel.org, Borislav Petkov <bp@alien8.de>,
        Oleg Nesterov <oleg@redhat.com>,
        Andrew Cooper <andrew.cooper3@citrix.com>,
        Brian Gerst <brgerst@gmail.com>,
        Linus Torvalds <torvalds@linux-foundation.org>,
        Andrew Morton <akpm@linux-foundation.org>,
        Peter Zijlstra <a.p.zijlstra@chello.nl>,
        Thomas Gleixner <tglx@linutronix.de>
Subject: Re: [PATCH] x86/entry: Improve system call entry comments
Message-ID: <20160308103004.GB5407@gmail.com>
References: <3cc149b4ce9a108a092d816c5158808c62c557f0.1457285880.git.luto@kernel.org>
 <20160307082228.GA11026@gmail.com>
 <85B7C74C-3B32-44D1-90FE-352097F0A627@zytor.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <85B7C74C-3B32-44D1-90FE-352097F0A627@zytor.com>
User-Agent: Mutt/1.5.23 (2014-03-12)
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 2467
Lines: 80


* H. Peter Anvin <hpa@zytor.com> wrote:

> On March 7, 2016 12:22:28 AM PST, Ingo Molnar <mingo@kernel.org> wrote:
> >
> >* Andy Lutomirski <luto@kernel.org> wrote:
> >
> >> Ingo suggested that the comments should explain when the various
> >> entries are used.  This adds these explanations and improves other
> >> parts of the comments.
> >
> >Thanks for doing this, this is really useful!
> >
> >One very small detail I noticed:
> >
> >> +/*
> >> + * 32-bit legacy system call entry.
> >> + *
> >> + * 32-bit x86 Linux system calls traditionally used the INT $0x80
> >> + * instruction.  INT $0x80 lands here.
> >> + *
> >> + * This entry point can be used by 32-bit and 64-bit programs to
> >perform
> >> + * 32-bit system calls.  Instances of INT $0x80 can be found inline
> >in
> >> + * various programs and libraries.  It is also used by the vDSO's
> >> + * __kernel_vsyscall fallback for hardware that doesn't support a
> >faster
> >> + * entry method.  Restarted 32-bit system calls also fall back to
> >INT
> >> + * $0x80 regardless of what instruction was originally used to do
> >the
> >> + * system call.
> >> + *
> >> + * This is considered a slow path.  It is not used by modern libc
> >> + * implementations on modern hardware except during process startup.
> >> + *
> >> + * Arguments:
> >> + * eax  system call number
> >> + * ebx  arg1
> >> + * ecx  arg2
> >> + * edx  arg3
> >> + * esi  arg4
> >> + * edi  arg5
> >> + * ebp  arg6
> >> + */
> >>  ENTRY(entry_INT80_32)
> >
> >entry_INT80_32() is only used on pure 32-bit kernels, 64-bit kernels
> >use 
> >entry_INT80_compat(). So the above text should not talk about 64-bit
> >programs, as 
> >they can never trigger this specific entry point, right?
> >
> >So I'd change the explanation to something like:
> >
> >> + * This entry point is active on 32-bit kernels and can thus be used
> >by 32-bit 
> >> + * programs to perform 32-bit system calls. (Programs running on
> >64-bit
> >> + * kernels executing INT $0x80 will land on another entry point: 
> >> + * entry_INT80_compat. The ABI is identical.)
> >
> >Agreed?
> >
> >Thanks,
> >
> >	Ingo
> 
> Sadly I believe Android still uses int $0x80 in the upstream version.

I don't see how that fact conflicts with my statement: on 64-bit kernels INT $0x80 
will (of course) work, but will land on another entry point: entry_INT80_compat(), 
not entry_INT80_32().

On 32-bit kernels the INT $0x80 entry point is entry_INT80_32().

Thanks,

	Ingo