From owner-svn-src-head@freebsd.org Wed Mar 7 18:31:32 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id ADC0DF47E28; Wed, 7 Mar 2018 18:31:31 +0000 (UTC) (envelope-from cem@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 56109865A7; Wed, 7 Mar 2018 18:31:31 +0000 (UTC) (envelope-from cem@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 50E9D2567B; Wed, 7 Mar 2018 18:31:31 +0000 (UTC) (envelope-from cem@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w27IVVkT066772; Wed, 7 Mar 2018 18:31:31 GMT (envelope-from cem@FreeBSD.org) Received: (from cem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w27IVVwA066771; Wed, 7 Mar 2018 18:31:31 GMT (envelope-from cem@FreeBSD.org) Message-Id: <201803071831.w27IVVwA066771@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: cem set sender to cem@FreeBSD.org using -f From: Conrad Meyer Date: Wed, 7 Mar 2018 18:31:31 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r330619 - head/share/man/man9 X-SVN-Group: head X-SVN-Commit-Author: cem X-SVN-Commit-Paths: head/share/man/man9 X-SVN-Commit-Revision: 330619 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Mar 2018 18:31:32 -0000 Author: cem Date: Wed Mar 7 18:31:31 2018 New Revision: 330619 URL: https://svnweb.freebsd.org/changeset/base/330619 Log: fpu_kern.9: Document fpu_kern_enter API change in r329878 While here, clean up some of the language. Reported by: delphij Sponsored by: Dell EMC Isilon Modified: head/share/man/man9/fpu_kern.9 Modified: head/share/man/man9/fpu_kern.9 ============================================================================== --- head/share/man/man9/fpu_kern.9 Wed Mar 7 18:31:01 2018 (r330618) +++ head/share/man/man9/fpu_kern.9 Wed Mar 7 18:31:31 2018 (r330619) @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 20, 2016 +.Dd March 7, 2018 .Dt FPU_KERN 9 .Os .Sh NAME @@ -34,7 +34,7 @@ .Fn fpu_kern_alloc_ctx "u_int flags" .Ft void .Fn fpu_kern_free_ctx "struct fpu_kern_ctx *ctx" -.Ft int +.Ft void .Fn fpu_kern_enter "struct thread *td" "struct fpu_kern_ctx *ctx" "u_int flags" .Ft int .Fn fpu_kern_leave "struct thread *td" "struct fpu_kern_ctx *ctx" @@ -139,19 +139,15 @@ after the function returns, as well as after each cont On i386 and amd64 this will be the .Nm Device Not Available exception (see Intel Software Developer Manual for the reference). -Currently, no errors are defined which can be returned by -.Fn fpu_kern_enter -to the caller. .Pp The .Fn fpu_kern_leave function ends the region started by .Fn fpu_kern_enter . -The uses of FPU in the kernel after the call to -.Fn fpu_kern_leave -are erroneous until the next call to +It is erroneous to use the FPU in the kernel before .Fn fpu_kern_enter -is performed. +or after +.Fn fpu_kern_leave . The function takes the .Fa td thread argument, which currently must be @@ -161,9 +157,9 @@ and the context pointer, previously passed to .Fn fpu_kern_enter . After the function returns, the context may be freed or reused -by other invocation of +by another invocation of .Fn fpu_kern_enter . -There are no errors defined for the function, it always returns 0. +The function always returns 0. .Pp The .Fn fpu_kern_thread @@ -210,3 +206,9 @@ facitily and this manual page were written by .An Konstantin Belousov Aq Mt kib@FreeBSD.org . The arm64 support was added by .An Andrew Turner Aq Mt andrew@FreeBSD.org . +.Sh BUGS +.Fn fpu_kern_leave +should probably have type +.Ft void +(like +.Fn fpu_kern_enter ) .