mysql-test-run.pl(1)

mariadb-test-run.pl(1)

NAMN

mariadb-test-run.pl – kör MariaDB:s testsvit

SYNOPSIS

mariadb-test-run.pl [alternativ]

BESKRIVNING

Perl-skriptet mariadb-test-run.pl är huvudprogrammet som används för att köra MariaDB:s testsvit. Det anropar mariadb-test för att köra enskilda testfall.

Kör mariadb-test-run.pl i katalogen mariadb-test så här:

shell> mariadb-test-run.pl [alternativ] [test_namn] ...

Varje argument test_namn namnger ett testfall. Testfallsfilen som motsvarar testnamnet är t/test_namn.test.

För varje argument test_namn kör mariadb-test-run.pl det namngivna testfallet. Utan några test_namn-argument kör mariadb-test-run.pl alla .test-filer i underkatalogen t.

Om inget suffix anges för testnamnet antas suffixet .test. Inledande sökväg ignoreras. Dessa kommandon är likvärdiga:

shell> mariadb-test-run.pl mytest
shell> mariadb-test-run.pl mytest.test
shell> mariadb-test-run.pl t/mytest.test

Ett svitnamn kan anges som en del av testnamnet. Syntaxen för att namnge ett test är:

[svit_namn.]test_namn[.suffix]

Om ett svitnamn anges letar mariadb-test-run.pl efter testet i den sviten. Testfilen som motsvarar ett test med namnet svit_namn.test_namn finns i suite/svit_namn/t/test_namn.test. Det finns också ett implicit svitnamn, main, för testerna i den översta t-katalogen. Utan svitnamn söker mariadb-test-run.pl i standardlistan över sviter efter en matchning och kör testet i varje svit där det hittas.

För att köra en familj av testfall vars namn delar ett gemensamt prefix används alternativet --do-test=prefix. Till exempel kör --do-test=rpl replikeringstesterna. --skip-test har motsatt effekt och hoppar över testfall vars namn delar ett gemensamt prefix.

Argumentet till --do-test och --skip-test tillåter också mer flexibel specificering. Om argumentet innehåller ett mönstermetatecken, annat än en ensam punkt, tolkas det som ett Perl-reguljärt uttryck och tillämpas på testnamn som matchar mönstret. Om argumentet innehåller en ensam punkt eller inga mönstermetatecken tolkas det som tidigare och matchar testnamn som börjar med argumentvärdet.

För att göra nödvändig initiering innan tester körs måste mariadb-test-run.pl kunna anropa mariadbd med alternativen --bootstrap och --skip-grant-tables. Om MariaDB konfigurerades med alternativet --disable-grant-options kommer --bootstrap, --skip-grant-tables och --init-file att vara inaktiverade. För att hantera detta kan miljövariabeln MYSQLD_BOOTSTRAP sättas till den fullständiga sökvägen till en server där alla alternativ är aktiverade. mariadb-test-run.pl använder då den servern för initiering, men inte för att köra själva testerna.

Testet init_file kommer att misslyckas om --init-file är inaktiverat. Detta är ett förväntat fel som kan hanteras så här:

shell> export MYSQLD_BOOTSTRAP
shell> MYSQLD_BOOTSTRAP=/full/path/to/mariadbd
shell> make test force="--skip-test=init_file"

För att köra mariadb-test-run.pl på Windows behövs antingen Cygwin eller ActiveState Perl. Du kan också behöva installera moduler som skriptet kräver. Byt till katalogen mariadb-test, sätt miljövariabeln MTR_VS_CONFIG till den konfiguration du valde tidigare, eller använd alternativet --vs-config, och kör sedan mariadb-test-run.pl. Exempel:

shell> cd mariadb-test
shell> export MTR_VS_CONFIG=debug
shell> ./mariadb-test-run.pl --force --timer
shell> ./mariadb-test-run.pl --force --timer --ps-protocol

mariadb-test-run.pl använder flera miljövariabler. Några av dem listas här:

Variabel	Betydelse
MTR_VERSION	Om satt till 1 körs den äldre version 1 av mariadb-test-run.pl.
MTR_MEM	Om satt körs tester med filer i minnet via tmpfs eller ramdisk. Motsvarar alternativet --mem.
MTR_PARALLEL	Om satt definierar den antalet parallella trådar som kör tester. Motsvarar --parallel.
MTR_BUILD_THREAD	Om satt definierar den vilket portintervall servern använder.
MTR_PORT_BASE	Om satt definierar den vilket portintervall servern använder.
MTR_NAMN_TIMEOUT	Timeout i minuter eller sekunder motsvarande kommandoradsalternativet --namn-timeout.
MYSQL_TEST	Sökväg till binären mariadb-test.
MYSQLD_BOOTSTRAP	Fullständig sökväg till mariadbd med alla alternativ aktiverade.
MYSQLTEST_VARDIR	Sökväg till katalogen var som används för loggar, temporära filer med mera.
MYSQL_TEST_DIR	Fullständig sökväg till katalogen mariadb-test där testerna körs.
MYSQL_TMP_DIR	Sökväg till den temporära katalog som används under tester.

Variabeln MTR_PORT_BASE lades till i MySQL 5.1.45 som en mer logisk ersättning för MTR_BUILD_THREAD. Den anger det faktiska portnumret direkt och avrundas nedåt till närmaste multipel av 10.

Tester förutsätter ibland att vissa miljövariabler är definierade. Exempelvis antar vissa tester att MYSQL_TEST är satt så att mariadb-test kan anropa sig självt med exec $MYSQL_TEST.

Om du kör version 1 av mariadb-test-run.pl genom att sätta MTR_VERSION, notera att detta bara påverkar testdrivrutinen, inte testklienten, testspråket eller testerna själva.

Några tester kanske inte fungerar med version 1 eftersom de är beroende av funktioner från version 2. Dessa kan hoppas över genom att lägga till testnamnet i filen lib/v1/incompatible.tests.

mariadb-test-run.pl stöder alternativen i följande lista. Ett argument -- talar om för mariadb-test-run.pl att inga följande argument ska tolkas som alternativ.

ALTERNATIV

--help, -h

Visa ett hjälpmeddelande och avsluta.

--big-test

Tillåt tester märkta som ”big” att köras. Upprepa alternativet två gånger för att endast köra ”big”-tester.

--boot-dbx

Kör mariadbd som används för bootstrap under felsökaren dbx.

--boot-ddd

Kör bootstrap-servern under ddd.

--boot-gdb

Kör bootstrap-servern under gdb.

--[mtr-]build-thread=nummer

Ange ett nummer som används för att beräkna portnummer enligt formeln 10 * build_thread + 10000. Värdet kan också vara auto.

--callgrind

Instruera valgrind att använda callgrind.

--check-testcases

Kontrollera testfall efter bieffekter genom att jämföra systemtillstånd före och efter varje testfall. Detta är aktiverat som standard.

--client-bindir=sökväg

Sökvägen till katalogen där klientbinärer finns.

--client-dbx

Starta mariadb-test i felsökaren dbx.

--client-ddd

Starta mariadb-test i felsökaren ddd.

--client-debugger=felsökare

Starta mariadb-test i den angivna felsökaren.

--client-gdb

Starta mariadb-test i felsökaren gdb.

--client-libdir=sökväg

Sökvägen till katalogen där klientbibliotek finns.

--combination=värde

Extra alternativ att skicka till mariadbd. Värdet ska bestå av ett eller flera kommaseparerade mariadbd-alternativ.

--comment=sträng

Skriv sträng i utdata inom rader fyllda med #, som en banner.

--compress

Komprimera all information som skickas mellan klient och server om båda stöder det.

--cursor-protocol

Använd markörprotokollet mellan klient och server. Innebär --ps-protocol.

--dbx

Starta mariadbd under dbx.

--ddd

Starta mariadbd under ddd.

--debug

Dumpa spårutdata för alla klienter och servrar.

--debug-common

Samma som --debug, men sätter debugflaggorna till "query,info,error,enter,exit".

--debug-server

Använd serverns debugversion utan att aktivera spårning.

--debugger=felsökare

Starta mariadbd med den angivna felsökaren.

--debug-sync-timeout=N

Styr om Debug Sync-funktionen är aktiverad. Standard är 300 sekunder. 0 inaktiverar Debug Sync.

--defaults-file=filnamn

Använd den angivna filen som fast mall för konfigurationsfil för alla tester.

--defaults_extra_file=filnamn

Lägg till inställningar från den angivna filen till alla genererade konfigurationer.

--do-test=prefix|regex

Kör alla testfall vars namn börjar med det angivna prefixet eller matchar ett reguljärt uttryck.

--dry-run

Kör inga tester, skriv bara ut listan över tester som skulle ha valts.

--embedded-server

Använd en version av mariadb-test som är byggd med inbäddad server.

--enable-disabled

Ignorera filer av typen disabled.def och kör även tester märkta som inaktiverade.

--experimental=filnamn

Ange en fil med testfall som ska rapporteras som [ exp-fail ] i stället för [ fail ] om de misslyckas.

--extern alternativ=värde

Använd en redan körande server.

--fast

Gör ingen kontrollerad avstängning när servrar måste startas om eller när testkörningen avslutas. Motsvarar --shutdown-timeout=0.

--force-restart

Starta alltid om servrar mellan tester.

--force

Normalt avslutas mariadb-test-run.pl om ett testfall misslyckas. --force gör att körningen fortsätter ändå.

--gcov

Samla täckningsinformation efter testet.

--gcov-src-dir

Samla täckning endast inom den angivna underkatalogen.

--gdb

Starta mariadbd under gdb.

--gprof

Samla profileringsinformation med gprof.

--manual-dbx

Använd en server som redan startats manuellt i dbx.

--manual-ddd

Använd en server som redan startats manuellt i ddd.

--manual-debug

Använd en server som redan startats manuellt i en felsökare.

--manual-gdb

Använd en server som redan startats manuellt i gdb.

--manual-lldb

Använd en server som redan startats manuellt i lldb.

--mark-progress

Markerar framsteg med tidsåtgång i millisekunder och radnummer i var/log/testnamn.progress.

--max-connections=antal

Maximalt antal samtidiga serveranslutningar per test.

--max-save-core=N

Begränsa antalet sparade core-filer. Standard är 5.

--max-save-datadir=N

Begränsa antalet datakataloger som sparas efter misslyckade tester. Standard är 20.

--max-test-fail=N

Stoppa körningen efter att angivet antal tester har misslyckats. Standard är 10.

--mem

Kör testsviten i minnet med tmpfs eller ramdisk. Stöds inte på Windows.

--mariadbd=värde

Extra alternativ att skicka till mariadbd.

--mariadbd-env=VAR=VÄRDE

Ange ytterligare miljövariabler för mariadbd.

--nocheck-testcases

Inaktivera kontrollen av bieffekter från testfall.

--noreorder

Omsortera inte tester för att minska antal omstarter. Kör dem exakt i given ordning.

--notimer

Gör att mariadb-test inte genererar en tidsfil.

--nowarnings

Leta inte efter och rapportera fel eller varningar i serverloggarna.

--parallel={N|auto}

Kör tester med N parallella trådar. Standard är 1.

--[mtr-]port-base=P

Ange basen för de portnummer som ska användas. Ett block om 10 portar allokeras.

--print-testcases

Kör inga tester, men skriv ut detaljer om alla tester i den ordning de skulle ha körts.

--ps-protocol

Använd det binära protokollet mellan klient och server.

--record

Skicka alternativet --record till mariadb-test. Kräver att ett specifikt testfall anges på kommandoraden.

--reorder

Omsortera tester för att minimera antalet serveromstarter. Detta är standard.

--repeat=N

Kör varje test N gånger.

--report-features

Kör först ett ”test” som rapporterar MariaDB-funktioner genom att visa utdata från SHOW ENGINES och SHOW VARIABLES.

--report-times

Rapportera hur mycket tid som har lagts på olika faser av testkörningen.

--retry=N

Om ett test misslyckas, försök igen upp till N gånger.

--retry-failure=N

När --retry används, stoppa när N fel har uppstått.

--shutdown-timeout=SEKUNDER

Maximalt antal sekunder att vänta på kontrollerad avstängning innan servern dödas. Standard är 10.

--skip-combinations

Tillämpa inte kombinationer.

--skip-rpl

Hoppa över replikeringstester.

--skip-ssl

Starta inte mariadbd med stöd för SSL-anslutningar.

--skip-test=regex

Ange ett reguljärt uttryck som används för att hoppa över testfall vars namn matchar det.

--skip-test-list=FIL

Hoppa över tester som listas i FIL.

--skip-*

--skip-*-alternativ som inte känns igen skickas vidare till masterservern.

--sleep=N

Skicka --sleep=N till mariadb-test.

--sp-protocol

Skapa en lagrad procedur för att köra alla frågor.

--ssl

Om mariadb-test-run.pl startas med --ssl sätts en säker anslutning upp för alla testfall.

--staging-run

Kör ett begränsat antal tester, utan långsamma tester. Används för staging-träd med valgrind.

--start

Initiera och starta servrar med startinställningarna för det angivna testfallet.

--start-and-exit

Samma som --start, men lämnar bara servern igång och avslutar testköraren.

--start-dirty

Liknar --start, men hoppar över databasinitiering och antar att databasfiler redan finns.

--start-from=test_namn

Börja köra testlistan från det angivna testnamnet.

--strace

Kör mariadbd med strace.

--strace-client

Skapa strace-utdata för mariadb-test.

--strace-option=ARG

Alternativ att ge till strace.

--stress=ARG

Kör stresstest och skicka alternativ till mariadb-stress-test.pl.

--suite[s]=svit_namn...

Kommaseparerad lista över sviter att köra.

--stop-file=fil

Om filen upptäcks startas inga nya tester förrän filen tas bort.

--stop-keep-alive=sek

Fungerar med --stop-file och skriver meddelanden periodiskt medan testköraren väntar.

--suite-timeout=minuter

Ange maximal körtid för testsviten i minuter. Standard är 360.

--testcase-timeout

Ange maximal körtid för testfall i minuter. Standard är 15.

--timediff

Används med --timestamp för att också skriva ut tiden sedan föregående test startade.

--timer

Gör att mariadb-test genererar en tidsfil. Standardfilen heter ./var/log/timer.

--timestamp

Skriv ut en tidsstämpel före testnamnet i varje testrapport.

--tmpdir=sökväg

Katalog där temporära filer lagras. Standard är ./var/tmp.

--user=användarnamn

MariaDB-användarnamnet som ska användas vid anslutning till servern. Standard är root.

--user-args

I kombination med start* och utan testnamn tas argument till mariadbd bort utom de som anges med --mariadbd.

--valgrind[-all]

Kör mariadb-test och mariadbd med valgrind.

--valgrind-mariadbd

Kör mariadbd med valgrind.

--valgrind-mariadb-test

Kör mariadb-test och mariadb-client-test med valgrind.

--valgrind-option=str

Alternativ att ge till valgrind.

--valgrind-path=sökväg

Sökväg till körbar fil för valgrind.

--vardir=sökväg

Ange sökvägen där filer genererade under testkörningen lagras. Standard är ./var.

--verbose

Mer utförlig information om testkörningen. Använd alternativet två gånger för ännu mer utdata.

--verbose-restart

Skriv ut när och varför servrar startas om mellan testfall.

--view-protocol

Skapa en vy för att köra alla frågor som inte uppdaterar data.

--vs-config=config_värde

Visual Studio-konfiguration som användes för att skapa körbara filer. Gäller endast Windows.

--wait-all

Om --start eller --start-dirty används, vänta tills alla servrar avslutas innan programmet avslutas.

--warnings

Sök igenom serverloggen efter fel eller varningar efter varje test och rapportera misstänkta poster. Detta är standardbeteendet.

UPPHOVSRÄTT

Copyright © 2007, 2010, Oracle och/eller dess dotterbolag, 2010–2025 MariaDB Foundation

Denna dokumentation är fri programvara; du får distribuera den vidare och/eller modifiera den endast enligt villkoren i GNU General Public License såsom publicerad av Free Software Foundation; version 2 av licensen.

Denna dokumentation distribueras i hopp om att den ska vara användbar, men UTAN NÅGON GARANTI; utan ens underförstådd garanti om SÄLJBARHET eller LÄMPLIGHET FÖR ETT VISST ÄNDAMÅL. Se GNU General Public License för mer information.

Du bör ha fått en kopia av GNU General Public License tillsammans med programmet; om inte, skriv till Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA eller se [1].

SE ÄVEN

För mer information, se MariaDB Knowledge Base, tillgänglig online på [2].

FÖRFATTARE

MariaDB Foundation ([3]).

KOLOFON

Denna sida är en del av projektet MariaDB (MariaDB-databasservern). Information om projektet finns på [4]. Om du har en felrapport för denna manualsida, se [5].

Denna sida hämtades från projektets uppströms Git-repository på [6] den 2026-01-16. Vid den tidpunkten var datumet för den senaste commit som hittades i repositoryt 2026-01-16.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller tror att det finns en bättre eller mer uppdaterad källa för sidan, eller har rättelser eller förbättringar av informationen i denna kolofon (som inte är en del av den ursprungliga manualsidan), skicka e-post till man-pages@man7.org.

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/mariadb-test-run.pl.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.