FUNCTION::SWITCH_FIL

Section: Output file switching Tapset (3stap)
Updated: October 2025
Index Return to Main Contents

NAME

function::switch_file - switch to the next output file

SYNOPSIS

    switch_file()

ARGUMENTS

None

DESCRIPTION

This function sends a signal to the stapio process, commanding it to rotate to the next output file when output is sent to file(s).

The mechanism of switching files was changed by upstream commit 5b39471380a238469c8fc18136f12600e5e9aec7 . With this commit, the rotation only works if there is some actual systemtap output.