From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5E02D37702B for ; Thu, 23 Apr 2026 22:44:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.133.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776984295; cv=none; b=B4lISyZLha4f1GndGdLQtAkg0cx0TBYTnoseASRuVfad9xTcZQ9cyqeBb7VEP8rrk9Zjeq2jRlsK4HLDYH/GlHmIiwoM+D6LwihFLBPelfnO1bPjgDq0dqRRt+t+ltEJRFGt9SoTgKPe48Z2Ov97iWg74sHGsblfLS1UiztXy+s= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776984295; c=relaxed/simple; bh=ARCXlgcBj7iXqgl4sGBs1kqXwSUW+g14rp947PKdQec=; h=Message-ID:Subject:From:To:Cc:Date:In-Reply-To:References: Content-Type:MIME-Version; b=XGdRJqP/39r4VTDP8uW8ZlmnJHfhHP29C1r+2qVl8zlBsODexTTeG73oj6vzQKhGBiVJoKbIyuPAxGFLoIcfoHeVaDImG2RX4g5iIfvEqmFE40E6ZhXv3+vRAMIMZphZsC/lrbnTvjWAOQtxk+OO7BKKaHV8x7DvZeDAl3f3oEk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=Ac8fW95O; dkim=pass (2048-bit key) header.d=redhat.com header.i=@redhat.com header.b=pSMs4Qei; arc=none smtp.client-ip=170.10.133.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="Ac8fW95O"; dkim=pass (2048-bit key) header.d=redhat.com header.i=@redhat.com header.b="pSMs4Qei" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1776984293; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=yzGKFLOEunQq2amrjlgcItgMg4F3fj2KAQL8+IiUKzw=; b=Ac8fW95ORbFsSgQQMyUOV5AtH1JYkt+aqdXQLrJ2TMiyvMZaVASYMd+MOr0YWcLK0lApWG PEx1D5DFh1Q2vz/0qc7QxFnTgQuOyiMMXdXeznY2EE+xQh9AKJiwHN2XcVPPdvc77X61TD LR3oB6codo9ORR4Y0Q5PWCTziyHsqMk= Received: from mail-qv1-f70.google.com (mail-qv1-f70.google.com [209.85.219.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-250-Iq6mH9hrMyGFGzq8JEwsGw-1; Thu, 23 Apr 2026 18:44:51 -0400 X-MC-Unique: Iq6mH9hrMyGFGzq8JEwsGw-1 X-Mimecast-MFC-AGG-ID: Iq6mH9hrMyGFGzq8JEwsGw_1776984291 Received: by mail-qv1-f70.google.com with SMTP id 6a1803df08f44-8ae752c5273so129804466d6.2 for ; Thu, 23 Apr 2026 15:44:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=google; t=1776984291; x=1777589091; darn=vger.kernel.org; h=mime-version:user-agent:content-transfer-encoding:references :in-reply-to:date:cc:to:from:subject:message-id:from:to:cc:subject :date:message-id:reply-to; bh=yzGKFLOEunQq2amrjlgcItgMg4F3fj2KAQL8+IiUKzw=; b=pSMs4Qei4eJ0X2vzj+ZDmtiCBQYmeVR/sTAWLFNNflh0h0PFoWt31QpRdj6yAAv+p7 +EAfhLQjen2mUnZdyaCc2m6tKeCW6Z1vNi7w5DcYdoa9YzxfidLtZ4YuaobueCxl4Rb0 vevTBs7dbLsskxVThLP1037WL8IuuGNqTjwFhXsnsg/wuqI79WvB0mnrdatNH+uRn28K vFrsuka11HJBJc3bMGP6uvzY5ag84uaViCkDh4Nm0q6vNDpGNEtuDmagYVV9EG9pIwz/ NZSG1Mbxw6aDZrr2/Giu6DAIyWhtpv9IOuEpA4FhzDwG3HM8PLUnuEFyTkL6YOmIshRd DKKQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776984291; x=1777589091; h=mime-version:user-agent:content-transfer-encoding:references :in-reply-to:date:cc:to:from:subject:message-id:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=yzGKFLOEunQq2amrjlgcItgMg4F3fj2KAQL8+IiUKzw=; b=OeUFQVoc03ZM1BZ63XB5bPe5AdI71HuUq4Za4A6aByyDRHXZJvoBbOZek8xLZyuFbu keAacEcj3OporSkzMMLS47ronMQpXeV81wVkuLA8js0aIYq9gAUZFMmm7jMae+VoU9Ao /UikNzUc7sGC/PrB1fVI3gzFFQtYwt3rtEDAKtJ5SahxtSZjmVUjj6v1qovuJ2t19LEx CSKr2wqxRLpby4F5wpNMA47zG0lC3Qex4t4Ok8E8u6haEPjI/LHrUZFMF5aNZ9VXTFEj kI0L4QhFoS0xdYts2sdPTOMhbOTcZoiPzSf2Y6TB25t4qG7Vxv4EEUdDqZXc/ykjAIHz Csxg== X-Forwarded-Encrypted: i=1; AFNElJ+7N4Vk2vKRAlLXZBHOBEtbh/MvBjJKKGOGzbNVE+dVwVKbWhfp49K0vKdY2AyjU8SiXtzQz3ZUFKxoc2s=@vger.kernel.org X-Gm-Message-State: AOJu0YzyN7gPEfwkm/SfxNHP8CE/yuYRhWq2dkNmsTiEuGgM/uN/2U9a X03iXkh3zVzOTx81WiGNGk7gTCFlXeSnKcqOfFBngFRJfxlQ1Q2J4lcZ1Xccvwow1luUSBcWB+i 6wYHyaM1i0V0ceCpcPuFsXK1Q5O3favm/DVT4uTTyu4v6L8gRlehmMF2WXD8RFPAvxw== X-Gm-Gg: AeBDieutVnNJ5GtWNYHV8aVbA/yGX7+Xnex7EX9DQQPJs0sO/TiCyYImspuY/m8Z+C/ rA97c1Fskd7IovYUIEf8FKFsntaW/gOAsAnyF0z92xrtEtXwejqNXHNhDLC6e6zg/A7xbDrUuhJ hIBPvdMmCVVULttLeF9MYwZYeK3Coq5CXtNncGWrj4Z5uw9L6+OTmaRJo0eVRsZ/br9CEXn8qSl fE1brl0enwd9C9dODaNvkYFirVP78kaghtzhzrac7SUeMl+VULQQmSwKxa/C98+kazaaLcHyEuI ZXFXdziTQ8MZojX5U/CJtzyDQXtgUZynC3dfs++9LrMKZnHWTo3QOprfWrnITFKCZq8eFPhXBNp urhiWYs1qQD7L91TcmOkq/cm2yEjpped3aYtRzOY1tqJKZ3G6VMNYUy4cIOoviz2T X-Received: by 2002:a05:6214:cc1:b0:8ac:b4b3:3ce2 with SMTP id 6a1803df08f44-8b02813ae21mr440651626d6.41.1776984291308; Thu, 23 Apr 2026 15:44:51 -0700 (PDT) X-Received: by 2002:a05:6214:cc1:b0:8ac:b4b3:3ce2 with SMTP id 6a1803df08f44-8b02813ae21mr440651306d6.41.1776984290870; Thu, 23 Apr 2026 15:44:50 -0700 (PDT) Received: from crwood-thinkpadp16vgen1.minnmso.csb ([2601:447:cc81:56d0:ab94:b2cb:29a6:7ac0]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-8b02ac4260bsm165590886d6.4.2026.04.23.15.44.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 23 Apr 2026 15:44:50 -0700 (PDT) Message-ID: Subject: Re: [PATCH] rtla: Document tests in README From: Crystal Wood To: Tomas Glozar , Steven Rostedt Cc: John Kacur , Luis Goncalves , Costa Shulyupin , Wander Lairson Costa , LKML , linux-trace-kernel Date: Thu, 23 Apr 2026 17:44:49 -0500 In-Reply-To: <20260423130759.882247-1-tglozar@redhat.com> References: <20260423130759.882247-1-tglozar@redhat.com> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.56.2 (3.56.2-2.fc42) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 On Thu, 2026-04-23 at 15:07 +0200, Tomas Glozar wrote: > RTLA tests are not documented anywhere. Mention both runtime and unit > tests in the README, with instructions on how to run them and a list of > dependencies and required system configuration. >=20 > Signed-off-by: Tomas Glozar > --- > tools/tracing/rtla/README.txt | 30 ++++++++++++++++++++++++++++++ > 1 file changed, 30 insertions(+) >=20 > diff --git a/tools/tracing/rtla/README.txt b/tools/tracing/rtla/README.tx= t > index a9faee4dbb3a..8a782cd2c171 100644 > --- a/tools/tracing/rtla/README.txt > +++ b/tools/tracing/rtla/README.txt > @@ -42,4 +42,34 @@ For development, we suggest the following steps for co= mpiling rtla: > $ make > $ sudo make install > =20 > +Running tests > + > +RTLA has two test suites: a runtime test suite and a unit test suite. > + > +The runtime test suite is available as "make check" (root required) and = has > +the following dependencies, in addition to RTLA build dependencies: > + > +- Perl > +- Test::Harness / TAP::Harness > +- bash > +- coreutils > +- ldd > +- util-linux > +- procps(-ng) > +- bpftool (if rtla is built against libbpf) > + > +as well as the following required system configuration: > + > +- CONFIG_OSNOISE_TRACER=3Dy > +- CONFIG_TIMERLAT_TRACER=3Dy > +- tracefs mounted and readable at /sys/kernel/tracing > + > +The unit test suite is available as "make unit-tests" and has the follow= ing > +dependencies: > + > +- libcheck > + > +Unlike the runtime test suite, root is not required to run unit tests, n= or is > +a tracefs/osnoise/timerlat-capable kernel required. > + Should add something explaining how to install "Test::Harness / TAP::Harness" for those who aren't familiar with the Perl ecosystem. -Crystal