CBMCTRL(1)

💖 CBMCTRL(1) 💖

okay so bestie, welcome to the User Commands section of the manual, and this little icon is cbmctrl ✨ — like, the whole manual page for cbmctrl version 0.4.99.103, built on Jul 14 2020 at 18:05:13. yes the build date is in the NAME section, we don't make the rules, we just vibe with them 🎀

🦋 NAME 🦋

cbmctrl — the manual page for cbmctrl version 0.4.99.103, built on Jul 14 2020 at 18:05:13. slay.

🌸 DESCRIPTION 🌸

cbmctrl version 0.4.99.103, built on Jul 14 2020 at 18:05:13 — and its whole thing? control serial CBM devices 💅 periodt.

⭐ Synopsis ⭐

cbmctrl  [global_options] [action] [action_opt] [--] [action_args]

✨ Global options ✨

• -h, --help — outputs this help screen if you specify it without an action. and if you do specify an action? it outputs some help information about that specific action. considerate king 👑
• -V, --version — outputs version information. that's it, that's the whole job 🫶
• -@, --adapter — tells OpenCBM which backend plugin and bus to use. this option requires an argument of the form <plugin>[:<bus>]. <plugin> is the backend plugin's name to use (e.g.: xa1541); <bus> is a bus unit identifier, if supported by the backend — so go look up the backend's documentation for the supported bus unit identifier(s) and the format for <bus> 🔍
• -p, --petscii — converts input or output parameter from CBM format (PETSCII) into PC format (ASCII). this is the default with all actions but open and command 🐚
• -r, --raw — do not convert data between CBM and PC format. this is the default with open and command 💀
• -- — the delimiter between action_opt and action_args. and bestie, listen: if any of the arguments in action_args starts with a -, make sure to set the -- so the argument is not treated as an option, accidentially 🙈 (yes, "accidentially", we stan the original spelling)

🧚 action: one of: 🧚

• lock — lock the parallel port for the use by cbm4win/cbm4linux.
• unlock — unlock the parallel port for the use by cbm4win/cbm4linux.
• listen — perform a listen on the IEC bus.
• talk — perform a talk on the IEC bus.
• unlisten — perform an unlisten on the IEC bus.
• untalk — perform an untalk on the IEC bus.
• open — perform an open on the IEC bus.
• popen — deprecated; use cbmctrl --petscii open instead! like, it still exists but it's giving legacy energy 😭
• close — perform a close on the IEC bus.
• read — read raw data from the IEC bus.
• write — write raw data to the IEC bus.
• put — put specified data to the IEC bus.
• status — give the status of the specified drive.
• command — issue a command to the specified drive.
• pcommand — deprecated; use cbmctrl --petscii command instead! same situation, use the new one bestie 💀
• dir — output the directory of the disk in the specified drive.
• download — download memory contents from the floppy drive.
• upload — upload memory contents to the floppy drive.
• srq — set the srq line on the IEC bus.
• usrq — unset the srq line on the IEC bus.
• clk — set the clk line on the IEC bus.
• uclk — unset the clk line on the IEC bus.
• reset — reset all drives on the IEC bus.
• detect — detect drives on the IEC bus.
• change — wait for a disk to be changed in the specified drive.

for more information on a specific action, try --help <action> 🫶

🔥 SEE ALSO 🔥

the full documentation for cbmctrl is maintained as a Texinfo manual — very main character of it, honestly 👑 if the info and cbmctrl programs are properly installed at your site, this command:

info cbmctrl

should give you access to the complete manual. iykyk ⭐

and that's the whole page, bestie 🌈 this was cbmctrl version 0.4.99.103, built on Jul 14 2020 at 18:05:13, dated July 2020, living in section CBMCTRL(1) — mwah, go control some serial CBM devices 💅💖🎀