targetclid(8)

📦
version 3.0.2 · 2 versions
, in centos-stream 10, centos-stream 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu resolute, ubuntu stonking

💖 targetclid — the girlboss daemon behind targetcli 💖

okay so bestie, welcome to targetclid(8) — she lives in the System Manager's Manual section of your friendly neighbourhood man pages, and she is lowkey the backbone of the whole targetcli operation. let's get into it 🫶

✨ NAME ✨

targetclid — the daemon component for targetcli. yes, she's that girl. 👑

🌸 DESCRIPTION 🌸

so here's the tea: targetclid is the daemon component of targetcli, and her whole job is to help retain the state of various configfs objects in memory. which means?? any new request or command can just directly use those in-memory objects instead of reconstructing them by parsing through the entire configfs files again and again and again for each and every single command. 😭

and like, that's the whole point — this greatly improves the overall execution time taken by targetcli commands at scale. it's giving ✨optimised✨, it's giving efficiency, it's giving main character energy fr fr. 💅

🎀 USAGE 🎀

targetclid [cmd]
  • --help — for additional usage information. your girl is happy to explain herself 💁‍♀️
  • --version — for version information. so you know exactly which era of targetclid you're dealing with 🏷️

🦋 QUICKSTART & EXAMPLES 🦋

to start using the daemon 🚀

you need to enable the targetclid socket, bestie:

$ systemctl enable targetclid.socket

if you want daemonized mode to be your default vibe 🫶

$ targetcli set global auto_use_daemon=true
$ targetcli ls

interactive mode 🌈

you can totally use interactive mode:

$ targetcli <hit-enter>
targetcli shell version 2.1.51
Entering targetcli interactive mode for daemonized approach.
Type 'exit' to quit.
/> pwd
/
/> cd /iscsi
/> pwd
/iscsi
/> exit
ngl the /> prompt is iconic. type exit to quit, she'll respect that 💅

batch mode 📦

you can also use batch mode for sending multiple commands in one go:

$ targetcli set global daemon_use_batch_mode=true
Parameter daemon_use_batch_mode is now 'true'.
$ targetcli <hit-enter>
targetcli shell version 2.1.51
Entering targetcli batch mode for daemonized approach.
Enter multiple commands separated by newline and type 'exit' to
run them all in one go.
/> ls
/> pwd
/> get global loglevel_file
/> exit

want to stop using daemonized mode? 🙈

you can set your preference to stop using daemonized mode even when the daemon is not running:

$ targetcli --disable-daemon

🍓 FILES 🍓

the sacred texts, the receipts, the whole filing cabinet 📁:

  • /etc/target/saveconfig.json
  • /etc/target/backup/*
  • /var/run/targetclid.sock
  • /var/run/targetclid.pid

💜 ENVIRONMENT 💜

TARGETCLI_HOME

if this variable is set, it points to a directory that should be used instead of ~/.targetcli. so like, if you wanna live somewhere else, she's not gonna stop you. 🏡✨

👑 SEE ALSO 👑

go read those too, bestie, knowledge is free 💖

💌 AUTHOR 💌

  • Written by Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
  • Man page written by Prasanna Kumar Kalever <prasanna.kalever@redhat.com>

we stan. 🫶

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, tell her directly:

pls be nice, she's trying her best 😭

and that's the whole page, bestie!! this was targetclid(8) from the System Manager's Manual — no version number or date on this one, so just know she's out here doing her daemon thing, slaying, retaining configfs state, periodt. 💅✨🌸 bye ily 🫶

📦 where this page comes from