Sys::De...lization(3)

📦
version 0.107 · 2 versions
, in fedora 43

✨ NAME ✨

okay so bestie, welcome to Sys::Detect::Virtualization — it's the little Perl module that sniffs around and tells you if your UNIX box is secretly running as a virtual machine 💅 no cap, it literally just detects whether you're a guest under virtualization.

🌸 VERSION 🌸

Version 0.107 — she's giving vintage but she works 💖

🦋 SYNOPSIS 🦋

the vibe check, in code form:

use Sys::Detect::Virtualization;

my $detector = eval { Sys::Detect::Virtualization->new() };
if( $@ ) {
    print "Detector may not be supported for your platform.  Error was: $@\n";
}

my @found = $detector->detect();
if( @found ) {
    print "Possible virtualized system.  May be running under:\n";
    print "\t$_\n" for @found;
}

🎀 DESCRIPTION 🎀

This module is out here trying to figure out whether your system is running as a guest under virtualization, and it does it with a bunch of heuristics 🔍 (fancy word for "educated guessing, bestie"). It's not one perfect test — it's a whole squad of little checks vibing together.

💜 METHODS 💜

👑 Class Methods

  • new ( $args ) — builds you a fresh detector object. Slays on success and hands you the object back. Fails? It dies. 💀
heads up: this constructor will fail if the system isn't running a supported OS. Currently, only Linux is supported. sorry to the BSD girlies 😭

$args is an optional hash reference with extra stuff for the constructor. Right now the supported keys are:

  • verbose — set to 1 if you want verbose debugging output, 0 if you don't. Defaults to 0.
  • ignore_host — set to 1 if we should report no virtualization whenever a virtualization host (not a guest) is detected. Defaults to 1.

🌈 Instance Methods

  • detect ( ) — runs the detection heuristics and returns a list of possible virtualization systems, or an empty list if it found nothing. Hits come back ordered from most likely to least likely. ✨
fr fr, not detecting anything does NOT mean the system isn't virtualized — it just means we couldn't detect it. absence of evidence, bestie, not evidence of absence 🙈
  • guess ( ) — runs the heuristics and returns a single answer based on the "best guess" available. Currently that's defined as the virt platform with the most heuristic hits. main character energy only, one winner 👑

🧚 Internal Methods

You probably shouldn't ever need to call these — they're backstage, iykyk 🙈

  • get_detectors ( ) — returns a list of all detector subroutines for the given instance.
  • _find_bin ( $command ) — returns the full path to the given command by searching $ENV{PATH}. If it's not in the path variable, the directories /usr/sbin, /usr/bin, /sbin, and /bin get appended.
  • _fh_apply_patterns ( $fh, $patterns ) — checks the data from $fh against the patterns in $patterns, line by line.

$patterns is a listref read pairwise. The first item of each pair is the pattern, and the second item of each pair is a list of names of virt solutions detected by the pattern.

  • _check_command_output ( $command, $patterns ) — checks the output of $command against the patterns in $patterns, line by line.

$patterns is a listref read pairwise. The first item of each pair is the pattern, and the second item of each pair is the name of the virt solution detected by the pattern.

  • _check_file_contents ( $fileglob, $patterns ) — checks the content of each filename in $fileglob against the patterns in $patterns, line by line.

$fileglob is a glob that returns zero or more filenames.

$patterns is a listref read pairwise. The first item of each pair is the pattern, and the second item of each pair is the name of the virt solution detected by the pattern.

  • _check_path_exists ( $paths ) — checks whether each path in $paths exists.

$paths is a listref read pairwise. The first item of each pair is the path name, and the second item of each pair is the name of the virt solution detected by the existence of that $path.

💖 AUTHOR 💖

Dave O'Neill, <dmo@dmo.ca> — legend behavior, honestly 🫶

💀 BUGS 💀

Known issues, bestie, let's be transparent:

  • No support for non-Linux platforms. Feel free to contribute an appropriate Sys::Detect::Virtualization::foo class for your platform. (be the change you want to see ✨)
  • No weighting of tests so that high-confidence checks can be done first. Patches welcome. 👀

Please report any bugs or feature requests to bug-sys-detect-virtualization at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Sys-Detect-Virtualization>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. so you literally never get ghosted 💅

🌟 SUPPORT 🌟

You can find documentation for this module with the perldoc command.

perldoc Sys::Detect::Virtualization

You can also look for information at:

  • RT: CPAN's request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Sys-Detect-Virtualization>

  • AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/Sys-Detect-Virtualization>

  • CPAN Ratings

<http://cpanratings.perl.org/d/Sys-Detect-Virtualization>

  • Search CPAN

<http://search.cpan.org/dist/Sys-Detect-Virtualization/>

  • The author's blog

<http://www.dmo.ca/blog/>

Copyright (C) 2009 Roaring Penguin Software Inc.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See <http://dev.perl.org/licenses/> for more information.

okay that's the whole page, bestie, you ate it all up 🍓 this was perl v5.42.0, dated 2025-07-25, and she's filed under Sys::De...lization(3) — iconic, no notes, periodt 💅✨

📦 where this page comes from