From patchwork Tue Sep 5 08:57:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Cyril Hrubis X-Patchwork-Id: 1829805 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=suse.cz header.i=@suse.cz header.a=rsa-sha256 header.s=susede2_rsa header.b=0uRXUAox; dkim=fail reason="signature verification failed" header.d=suse.cz header.i=@suse.cz header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=48TOENp/; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.linux.it (client-ip=2001:1418:10:5::2; helo=picard.linux.it; envelope-from=ltp-bounces+incoming=patchwork.ozlabs.org@lists.linux.it; receiver=patchwork.ozlabs.org) Received: from picard.linux.it (picard.linux.it [IPv6:2001:1418:10:5::2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1)) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4Rfzs060X9z1ygc for ; Tue, 5 Sep 2023 18:56:52 +1000 (AEST) Received: from picard.linux.it (localhost [IPv6:::1]) by picard.linux.it (Postfix) with ESMTP id B5F943CB807 for ; Tue, 5 Sep 2023 10:56:50 +0200 (CEST) X-Original-To: ltp@lists.linux.it Delivered-To: ltp@picard.linux.it Received: from in-7.smtp.seeweb.it (in-7.smtp.seeweb.it [217.194.8.7]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-384)) (No client certificate requested) by picard.linux.it (Postfix) with ESMTPS id DDD463CB794 for ; Tue, 5 Sep 2023 10:56:48 +0200 (CEST) Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by in-7.smtp.seeweb.it (Postfix) with ESMTPS id 4B59A200BC5 for ; Tue, 5 Sep 2023 10:56:48 +0200 (CEST) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id C3A5F211CE; Tue, 5 Sep 2023 08:56:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1693904207; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ZOR2pV8xjDBGwXlMZG9MHvD6llKWksv/aBBeZECurlI=; b=0uRXUAoxLTvwRfxAq8mrr3xVEUBR9JBs/GgBfJOsEWiwAaYhogoTcrDtv53SmhkCESeNbd al2w1U0BGqC+DmA0rvWAWCXqYgqpXRSTaHvsWyoIUDoeziFGOIwNeqRgkqu7nMfvT/nUfx oOPd4dOIfdcqsC55MpqI+7wOapMhBuw= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1693904207; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ZOR2pV8xjDBGwXlMZG9MHvD6llKWksv/aBBeZECurlI=; b=48TOENp/vL2zgFn6659GO7Dwd1p/A+euAeieOvEmCh454jSqu/LKnriFYMmmo59O2XYlGI MFe56I7+J+s+krDg== Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id B117413499; Tue, 5 Sep 2023 08:56:47 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id ENb/KU/t9mR/HgAAMHmgww (envelope-from ); Tue, 05 Sep 2023 08:56:47 +0000 From: Cyril Hrubis To: ltp@lists.linux.it Date: Tue, 5 Sep 2023 10:57:25 +0200 Message-ID: <20230905085726.11038-1-chrubis@suse.cz> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 X-Virus-Scanned: clamav-milter 1.0.1 at in-7.smtp.seeweb.it X-Virus-Status: Clean X-Spam-Status: No, score=0.1 required=7.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=disabled version=4.0.0 X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on in-7.smtp.seeweb.it Subject: [LTP] [PATCH] doc: Add .min_swap_avail X-BeenThere: ltp@lists.linux.it X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux Test Project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ltp-bounces+incoming=patchwork.ozlabs.org@lists.linux.it Sender: "ltp" Signed-off-by: Cyril Hrubis Reviewed-by: Li Wang --- doc/c-test-api.txt | 13 +++++++++---- doc/test-writing-guidelines.txt | 1 + 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/doc/c-test-api.txt b/doc/c-test-api.txt index f692909e2..373af0cd4 100644 --- a/doc/c-test-api.txt +++ b/doc/c-test-api.txt @@ -2328,11 +2328,16 @@ both V1 and V2 feasible. Some tests require more than specific number of CPU. It can be defined with `.min_cpus = N`. -1.39 Require minimum size of MemAvailable for a testcase -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +1.39 Require minimum memory or swap size for a testcase +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some tests require at least size(MB) of free RAM or Swap. + +To make sure that test will run only on systems with more than minimal +required amount of RAM set `.min_mem_avail = N`. -Some tests require more than specific size(MB) of MemAvailable. It can be defined -with `.min_mem_avail = N`. +Similarily for tests that require certain amount of free Swap use +`.min_swap_avail = N`. 1.40 Test tags ~~~~~~~~~~~~~~ diff --git a/doc/test-writing-guidelines.txt b/doc/test-writing-guidelines.txt index 6d1a69165..e2edc658a 100644 --- a/doc/test-writing-guidelines.txt +++ b/doc/test-writing-guidelines.txt @@ -370,6 +370,7 @@ https://github.com/linux-test-project/ltp/wiki/Shell-Test-API[Shell Test API]. | '.min_kver' | 'TST_MIN_KVER' | '.min_mem_avail' | not applicable | '.mnt_flags' | 'TST_MNT_PARAMS' +| '.min_swap_avail' | not applicable | '.mntpoint', '.mnt_data' | 'TST_MNTPOINT' | '.mount_device' | 'TST_MOUNT_DEVICE' | '.needs_cgroup_ctrls' | –