Received: by 2002:a25:ad19:0:0:0:0:0 with SMTP id y25csp9408852ybi; Wed, 10 Jul 2019 09:45:38 -0700 (PDT) X-Google-Smtp-Source: APXvYqwPfRl85J1SBNTlg6k3e5l17y2Pp2FEulg/UI4YulOtBsvrIqifYU8a3OHkr3tPKg6ivjJQ X-Received: by 2002:a17:902:fe93:: with SMTP id x19mr37217994plm.77.1562777138533; Wed, 10 Jul 2019 09:45:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1562777138; cv=none; d=google.com; s=arc-20160816; b=dv1L7+ACrDx+VXsSThU0W0tFClQkVqi3VnhkKri1s8VhbpOzgNdyncW5PlfATRJq9/ 14v6YPvTjnBAkvqs9ewks+gc0SioCA0TRMGZJHYugccbiUOuToE1JxHLkraJ2VEg8HP4 8pSixbG+8+TGbpCpGnqtS9wshyilg9MNx8UhAvUbQwz5idtdxW4a5A2HvaNDWfcSJrqB erZ1J8yZhkkIJsZ8Ay7G3FtWFelVK7TEhumAitsjaYVNlPITzDkA/pq+VjhJgT7pjr9/ CuBH+5LT3xMaDX7HtSzI/G0fs9LHiiyTLqRUWPnAuZ+aaOQTv6aR8HmpooDMYHpNjaaz 0C6g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=C1wKrfnxE3aI/zW2IlICe9/kKX5YLvazS2tqbYwzR+s=; b=rnCGE24loxKkauFDJMMCK2PWdvGUBJSjoLA2cf7rjW/N5fAHpjGcnJ5C4N18sQlSPF /++ohfvYHrVGunEBjv/JsRc2fK7T1K3BRq7Pj/YKaS++V+kHxF2IskrfEoT7C8kF7+xV R2UY+zSQG5/uLkKGXlhl6Oy44tFFc/t4hClipxfaYBvrLf0FzseHQDNZx6r54of9Ldgy 0/KBaTpLFzPOY0+sUiCWgjGqvRMVCPGBd7X3Md92aO2Kcm49W7gvO3nM8C7duRNA+I2W E78dcGZzG63gu9feXm+sWao7E7Aj4iXxujQcJKjFGb0P5Yw8wFzskJTEmGJMur/zshnB yF9g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@eng.ucsd.edu header.s=google header.b=Lt9tEdlf; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=ucsd.edu Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id x21si2485908pgh.400.2019.07.10.09.45.21; Wed, 10 Jul 2019 09:45:38 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@eng.ucsd.edu header.s=google header.b=Lt9tEdlf; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=ucsd.edu Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728119AbfGJPbf (ORCPT + 99 others); Wed, 10 Jul 2019 11:31:35 -0400 Received: from mail-lj1-f193.google.com ([209.85.208.193]:40447 "EHLO mail-lj1-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728093AbfGJPbd (ORCPT ); Wed, 10 Jul 2019 11:31:33 -0400 Received: by mail-lj1-f193.google.com with SMTP id m8so2524169lji.7 for ; Wed, 10 Jul 2019 08:31:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eng.ucsd.edu; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=C1wKrfnxE3aI/zW2IlICe9/kKX5YLvazS2tqbYwzR+s=; b=Lt9tEdlf/gZn4VTbkqpKUtk0yBIj0i1oFbgIxKD+jkjofB9nYD7V2uLfHpoXrkdLTx NddoA0ouc8CwjRwyrW+zJC8NqAJAG4EteW9bapre+WW88VVW/3z79sGNTxMMnArP58Rs sZHXZBaRIbSMAUshC1WD2E24T9nAx+236CsiI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=C1wKrfnxE3aI/zW2IlICe9/kKX5YLvazS2tqbYwzR+s=; b=rUbczGJWyFDqsIEi4nQCUlnkGbuHQaQYzHkNIzjfDD5/Sz7sQmN5eaI8qAt22ILrVZ O0P8Svm3dCdCHXMRF/zFYw6rHQLkpD8kFTSMdmDzxoQonlETtSzQw4+HA7FksAlgpxr7 NMYm2522ZU/28Qu37ZeK7Usz7dFRdV13a9UWe2O+YTd0Jiltjn73x02hALQOyNNQy44H Ml3glQQrNFc2yNu0BlNUgwyed0RiiOOmMphNu6sWvW8dhBqbRRoVIoGOZDZJOeIB+vzn aabI2fG0ZWK8hBhxHKi8oMzC7I8cOrQic2x3Sois448OhnxFD5uRw41LLGjV38tdmPOQ khZQ== X-Gm-Message-State: APjAAAVcIP0SG/92YmOymmviLtvFpUJfcjfHTHe7gcLkMUUa2C1hX8zZ ociRExEMnk2rwEQgJb3LP14kAWKDuwU= X-Received: by 2002:a2e:8892:: with SMTP id k18mr18168234lji.239.1562772691184; Wed, 10 Jul 2019 08:31:31 -0700 (PDT) Received: from luke-XPS-13.home (159-205-76-204.adsl.inetia.pl. [159.205.76.204]) by smtp.gmail.com with ESMTPSA id o17sm517208ljg.71.2019.07.10.08.31.30 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 10 Jul 2019 08:31:30 -0700 (PDT) From: Luke Nowakowski-Krijger X-Google-Original-From: Luke Nowakowski-Krijger To: linux-kernel-mentees@lists.linuxfoundation.org Cc: Luke Nowakowski-Krijger , pbonzini@redhat.com, rkrcmar@redhat.com, corbet@lwn.net, kvm@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 1/3] Documentation: virtual: Convert paravirt_ops.txt to .rst Date: Wed, 10 Jul 2019 08:30:52 -0700 Message-Id: <20190710153054.29564-2-lnowakow@neg.ucsd.edu> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190710153054.29564-1-lnowakow@neg.ucsd.edu> References: <20190710153054.29564-1-lnowakow@neg.ucsd.edu> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Luke Nowakowski-Krijger Convert paravirt_opts.txt to .rst format to be able to be parsed by sphinx. Made some minor spacing and formatting corrections to make defintions much more clear and easy to read. Added default kernel license to the document. Signed-off-by: Luke Nowakowski-Krijger --- Changes since v3: none Changes since v2: none Changes since v1: + Converted doc to .rst format .../{paravirt_ops.txt => paravirt_ops.rst} | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) rename Documentation/virtual/{paravirt_ops.txt => paravirt_ops.rst} (65%) diff --git a/Documentation/virtual/paravirt_ops.txt b/Documentation/virtual/paravirt_ops.rst similarity index 65% rename from Documentation/virtual/paravirt_ops.txt rename to Documentation/virtual/paravirt_ops.rst index d4881c00e339..6b789d27cead 100644 --- a/Documentation/virtual/paravirt_ops.txt +++ b/Documentation/virtual/paravirt_ops.rst @@ -1,3 +1,6 @@ +.. SPDX-License-Identifier: GPL-2.0 + +============ Paravirt_ops ============ @@ -18,15 +21,15 @@ at boot time. pv_ops operations are classified into three categories: - simple indirect call - These operations correspond to high level functionality where it is - known that the overhead of indirect call isn't very important. + These operations correspond to high level functionality where it is + known that the overhead of indirect call isn't very important. - indirect call which allows optimization with binary patch - Usually these operations correspond to low level critical instructions. They - are called frequently and are performance critical. The overhead is - very important. + Usually these operations correspond to low level critical instructions. They + are called frequently and are performance critical. The overhead is + very important. - a set of macros for hand written assembly code - Hand written assembly codes (.S files) also need paravirtualization - because they include sensitive instructions or some of code paths in - them are very performance critical. + Hand written assembly codes (.S files) also need paravirtualization + because they include sensitive instructions or some of code paths in + them are very performance critical. -- 2.20.1