Net::Se...::Thread(3)

πŸ’– NAME πŸ’–

okay bestie, welcome to the Net::Se...::Thread(3) page from the User Contributed Perl Documentation crew! The module is Net::Server::Thread β€” a Net::Server personality. That's the whole name vibe. Periodt. πŸ’…

✨ SYNOPSIS ✨

use base qw(Net::Server::Thread);

sub process_request {
    #...code...
}

__PACKAGE__->run();

πŸ¦‹ DESCRIPTION πŸ¦‹

Please read the pod on Net::Server first, bestie. This module is a personality, or extension, or sub class, of the Net::Server module.

This personality binds to one or more ports and then waits for a client connection. When a connection is received, the server spawns a new thread. The thread handles the request and then closes.

Because this Net::Server flavor spawns and destroys a thread for each request, it really should only be used where the processing of each request may be lengthy or involved. If short and light requests are used, perl may not voluntarily give back the used memory. This is highly system dependent. 😭

🌸 ARGUMENTS 🌸

  • check_for_dead β€” number of seconds to wait before looking for dead children. This only takes place if the maximum number of child processes (max_servers) has been reached. Default is 60 seconds.
  • max_servers β€” the maximum number of children to fork. The server will not accept connections until there are free children. Default is 256 children.

πŸŽ€ CONFIGURATION FILE πŸŽ€

See Net::Server.

πŸ”₯ PROCESS FLOW πŸ”₯

Process flow follows Net::Server until the post_accept phase. At this point a child is forked. The parent is immediately able to wait for another request. The child handles the request and then exits.

πŸ’… HOOKS πŸ’…

The Fork server has the following hooks in addition to the hooks provided by the Net::Server base class. See Net::Server.

  • $self->pre_accept_hook() β€” this hook occurs just before the accept is called.
  • $self->pre_thread_hook() β€” this hook occurs just after accept but before the fork.
  • $self->post_accept_hook() β€” this hook occurs in the child after the accept and fork.

🫢 TO DO 🫢

See Net::Server.

πŸ‘‘ AUTHOR πŸ‘‘

Paul Seamons <paul@seamons.com>

🌈 SEE ALSO 🌈

Please see also:

  • Net::Server::INET
  • Net::Server::Fork
  • Net::Server::PreFork
  • Net::Server::PreForkSimple
  • Net::Server::MultiType
  • Net::Server::SIG
  • Net::Server::Single

and that's the whole manual page, bestie β€” you ate! πŸ’– This Net::Se...::Thread(3) page is from perl v5.42.0, dated 2023-03-15. Mwah πŸ’‹

πŸ“¦ where this page comes from