An array of objects of this type are returned by the method C<fuser> in
L<doc:Linux::Fuser>.  It describes a single process that has the requested
file open.


Because it has to read special files that may only be readable by the user that
owns the process it may not work as expected for users other than the superuser.


Typically objects of this type will be created as needed by C<fuser> and there
should be no need for user code to construct new objects.


use v6;

use nqp;
use Linux::Fuser::FileDescriptor;
# For the time being
use System::Passwd:auth<zef:raku-community-modules>;



Linux::Fuxer::Procinfo - describe the process that has a file opened.


NAME

DESCRIPTION

There are no public methods only read-only attributes.


ATTRIBUTES


class Linux::Fuser::Procinfo {
    #| The process ID of the process that has the file open
    has Int $.pid;
    #| The username of the user who owns the process
    has Str $.user;
    #| An array of the parts of the command that this process represents, i.e the argv
    #| as passed to the system execve()
    has Str @.cmd;
    #| A L<doc:Linux::Fuser::FileDescriptor> that describes the file as the process
    #| has it opened.
    has Linux::Fuser::FileDescriptor $.filedes;

    #| The L<doc:IO::Path> describing the /proc entry
    #| This is passed to the constructor
    has IO::Path $.proc-file;
    #| The L<doc:IO::Path> that corresponds to the /proc/<pid>/fd entry for the file
    has IO::Path $.fd-file;


    submethod BUILD(:$!proc-file, :$!fd-file) {
        $!pid = $!proc-file.basename + 0;
        my $cmdline = $!proc-file.append('cmdline');
        # rather awkward locution but basically cmdline is a copy of the argv
        # as got to execve with the \0s and everything
        my $cmd_fh = $cmdline.open(:bin);
        @!cmd = $cmd_fh.read(4096).decode.split("\0");
        $!filedes = Linux::Fuser::FileDescriptor.new(proc-file => $!proc-file, fd-file => $!fd-file);

        if ((my $uid = self!lstat_uid()).defined ) {
            $!user = get-user-by-uid($uid).username;
        }
    }

    #| supply the required missing part of lstat() to get the owner of the FD
    method !lstat_uid() {
        nqp::p6box_i(nqp::stat(nqp::unbox_s($!fd-file.Str), nqp::const::STAT_UID));
    }
}
# vim: expandtab shiftwidth=4 ft=raku


root

This module provides information similar to the Unix command 'fuser'
about which processes have a particular file open.  The way that this
works is highly unlikely to work on any other OS other than Linux and
even then it may not work on other than 2.2.* kernels. Some features
may not work correctly on kernel versions older than 2.6.22


It should also be borne in mind that this may not produce entirely
accurate results unless you are running the program as the Superuser
as the module will require access to files in /proc that may only be
readable by their owner.


Linux::Fuser - Determine which processes have a file open


This provides additional information about the file descriptor instance as
opened by a process.  Typically it will be accessed via the C<fdinfo> attribute
of L<doc:Linux::Fuser::Procinfo> and need not be constructed in user code.


Because it needs to read the C</proc/<pid>/fdinfo/<fd>> entry which will only be
readable by the user that has the file open this may not work as expected unless
run by the superuser.


Linux::Fuser::FileDescriptor - describe a file opened by a process


para

React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<AI|file:../mcp/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>
    =item2 L<Hand these documents to an AI assistant|file:../mcp/index.podlite>

=end nested
=begin nested :!nested
=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>

=end nested
=end React


Built with L<Podlite|https://podlite.org> — the markup and publishing tools behind this site.


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


Linux::Fuxer::Procinfo - describe the process that has a file opened.

NAME

ATTRIBUTES

Linux::Fuser v0.0.16

Authors

License

Dependencies

Test Dependencies

Provides

Documentation