COMEDI_INTERNAL_TRIG(3)

✨ COMEDI_INTERNAL_TRIG ✨

okay bestie, so this is a page from the Comedi reference manual — the 3 section, meaning it's a library function you call from your own code. It's called comedi_internal_trigger and it's about generating a soft trigger. yes we are triggering things today 💅

---

🌸 NAME 🌸

comedi_internal_trigger — generate soft trigger

like literally the whole point is making an internal trigger happen. slay.

---

🎀 SYNOPSIS 🎀

#include <comedilib.h>

int comedi_internal_trigger(comedi_t * device, unsigned int subdevice,
                            unsigned int trig_num);

---

💖 DESCRIPTION 💖

so here's the vibe: this function sends an INSN_INTTRIG instruction to a subdevice, which causes an internal triggering event. and what does that even do? it can, for example, trigger a subdevice to start an asynchronous command. it's giving ✨starting something✨.

the trig_num parameter is reserved for future use, and should be set to 0. no cap. the tea is that it's likely it will be used in the future to support multiple independent internal triggers. for example, imagine an asynchronous command gets specified for a subdevice with a start_src of TRIG_INT, and a start_arg of 5. in that case, the start event would only be triggered if comedi_internal_trigger were called on the subdevice with a trig_num equal to that same value of 5. iconic future behaviour, but for now: just put 0 and move on bestie 🫶

---

🦋 RETURN VALUE 🦋

• 0 on success
• -1 on error

that's it. that's the whole vibe check. 😭

---

👑 AUTHORS 👑

• David Schleef <ds@schleef.org> — Author.
• Frank Mori Hess <fmhess@users.sourceforge.net> — Author.
• Herman Bruyninckx <Herman.Bruyninckx@mech.kuleuven.ac.be> — Author.
• Bernd Porr <tech@linux-usb-daq.co.uk> — Author.
• Ian Abbott <abbotti@mev.co.uk> — Author.
• Éric Piel <piel@delmic.com> — Author.

six whole authors. the group project actually got finished, we love to see it 🌈

---

⭐ COPYRIGHT ⭐

Copyright © 1998-2003 David Schleef
Copyright © 2001-2003, 2005, 2008 Frank Mori Hess
Copyright © 2002-2003 Herman Bruyninckx
Copyright © 2012 Bernd Porr
Copyright © 2012 Ian Abbott
Copyright © 2012, 2015 Éric Piel

This document is part of Comedilib. In the context of this document, the term "source code" as defined by the license is interpreted as the XML source. (yes, the XML source specifically. they said what they said. 📎)

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 2.1 of the License.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. (dramatic but important, bestie. the lawyers said it, not me.)

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. like an actual physical letter. to Massachusetts. 🫶

---

🧚 real talk: set that trig_num to 0 unless the future arrives, and remember 0 = good, -1 = not good. that's the whole page. go trigger something soft. 💅

---

k bye, this was the Comedi reference, COMEDI_INTERNAL_TRIG(3), dated 03/20/2026 — version vibes courtesy of the Comedi crew. mwah 💖