kcapi.c 30 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318
  1. /* $Id: kcapi.c,v 1.1.2.8 2004/03/26 19:57:20 armin Exp $
  2. *
  3. * Kernel CAPI 2.0 Module
  4. *
  5. * Copyright 1999 by Carsten Paeth <calle@calle.de>
  6. * Copyright 2002 by Kai Germaschewski <kai@germaschewski.name>
  7. *
  8. * This software may be used and distributed according to the terms
  9. * of the GNU General Public License, incorporated herein by reference.
  10. *
  11. */
  12. #define AVMB1_COMPAT
  13. #include "kcapi.h"
  14. #include <linux/module.h>
  15. #include <linux/mm.h>
  16. #include <linux/interrupt.h>
  17. #include <linux/ioport.h>
  18. #include <linux/proc_fs.h>
  19. #include <linux/sched/signal.h>
  20. #include <linux/seq_file.h>
  21. #include <linux/skbuff.h>
  22. #include <linux/workqueue.h>
  23. #include <linux/capi.h>
  24. #include <linux/kernelcapi.h>
  25. #include <linux/init.h>
  26. #include <linux/moduleparam.h>
  27. #include <linux/delay.h>
  28. #include <linux/slab.h>
  29. #include <linux/uaccess.h>
  30. #include <linux/isdn/capicmd.h>
  31. #include <linux/isdn/capiutil.h>
  32. #ifdef AVMB1_COMPAT
  33. #include <linux/b1lli.h>
  34. #endif
  35. #include <linux/mutex.h>
  36. #include <linux/rcupdate.h>
  37. static int showcapimsgs = 0;
  38. static struct workqueue_struct *kcapi_wq;
  39. MODULE_DESCRIPTION("CAPI4Linux: kernel CAPI layer");
  40. MODULE_AUTHOR("Carsten Paeth");
  41. MODULE_LICENSE("GPL");
  42. module_param(showcapimsgs, uint, 0);
  43. /* ------------------------------------------------------------- */
  44. struct capictr_event {
  45. struct work_struct work;
  46. unsigned int type;
  47. u32 controller;
  48. };
  49. /* ------------------------------------------------------------- */
  50. static const struct capi_version driver_version = {2, 0, 1, 1 << 4};
  51. static char driver_serial[CAPI_SERIAL_LEN] = "0004711";
  52. static char capi_manufakturer[64] = "AVM Berlin";
  53. #define NCCI2CTRL(ncci) (((ncci) >> 24) & 0x7f)
  54. LIST_HEAD(capi_drivers);
  55. DEFINE_MUTEX(capi_drivers_lock);
  56. struct capi_ctr *capi_controller[CAPI_MAXCONTR];
  57. DEFINE_MUTEX(capi_controller_lock);
  58. struct capi20_appl *capi_applications[CAPI_MAXAPPL];
  59. static int ncontrollers;
  60. static BLOCKING_NOTIFIER_HEAD(ctr_notifier_list);
  61. /* -------- controller ref counting -------------------------------------- */
  62. static inline struct capi_ctr *
  63. capi_ctr_get(struct capi_ctr *ctr)
  64. {
  65. if (!try_module_get(ctr->owner))
  66. return NULL;
  67. return ctr;
  68. }
  69. static inline void
  70. capi_ctr_put(struct capi_ctr *ctr)
  71. {
  72. module_put(ctr->owner);
  73. }
  74. /* ------------------------------------------------------------- */
  75. static inline struct capi_ctr *get_capi_ctr_by_nr(u16 contr)
  76. {
  77. if (contr < 1 || contr - 1 >= CAPI_MAXCONTR)
  78. return NULL;
  79. return capi_controller[contr - 1];
  80. }
  81. static inline struct capi20_appl *__get_capi_appl_by_nr(u16 applid)
  82. {
  83. lockdep_assert_held(&capi_controller_lock);
  84. if (applid < 1 || applid - 1 >= CAPI_MAXAPPL)
  85. return NULL;
  86. return capi_applications[applid - 1];
  87. }
  88. static inline struct capi20_appl *get_capi_appl_by_nr(u16 applid)
  89. {
  90. if (applid < 1 || applid - 1 >= CAPI_MAXAPPL)
  91. return NULL;
  92. return rcu_dereference(capi_applications[applid - 1]);
  93. }
  94. /* -------- util functions ------------------------------------ */
  95. static inline int capi_cmd_valid(u8 cmd)
  96. {
  97. switch (cmd) {
  98. case CAPI_ALERT:
  99. case CAPI_CONNECT:
  100. case CAPI_CONNECT_ACTIVE:
  101. case CAPI_CONNECT_B3_ACTIVE:
  102. case CAPI_CONNECT_B3:
  103. case CAPI_CONNECT_B3_T90_ACTIVE:
  104. case CAPI_DATA_B3:
  105. case CAPI_DISCONNECT_B3:
  106. case CAPI_DISCONNECT:
  107. case CAPI_FACILITY:
  108. case CAPI_INFO:
  109. case CAPI_LISTEN:
  110. case CAPI_MANUFACTURER:
  111. case CAPI_RESET_B3:
  112. case CAPI_SELECT_B_PROTOCOL:
  113. return 1;
  114. }
  115. return 0;
  116. }
  117. static inline int capi_subcmd_valid(u8 subcmd)
  118. {
  119. switch (subcmd) {
  120. case CAPI_REQ:
  121. case CAPI_CONF:
  122. case CAPI_IND:
  123. case CAPI_RESP:
  124. return 1;
  125. }
  126. return 0;
  127. }
  128. /* ------------------------------------------------------------ */
  129. static void
  130. register_appl(struct capi_ctr *ctr, u16 applid, capi_register_params *rparam)
  131. {
  132. ctr = capi_ctr_get(ctr);
  133. if (ctr)
  134. ctr->register_appl(ctr, applid, rparam);
  135. else
  136. printk(KERN_WARNING "%s: cannot get controller resources\n",
  137. __func__);
  138. }
  139. static void release_appl(struct capi_ctr *ctr, u16 applid)
  140. {
  141. DBG("applid %#x", applid);
  142. ctr->release_appl(ctr, applid);
  143. capi_ctr_put(ctr);
  144. }
  145. static void notify_up(u32 contr)
  146. {
  147. struct capi20_appl *ap;
  148. struct capi_ctr *ctr;
  149. u16 applid;
  150. mutex_lock(&capi_controller_lock);
  151. if (showcapimsgs & 1)
  152. printk(KERN_DEBUG "kcapi: notify up contr %d\n", contr);
  153. ctr = get_capi_ctr_by_nr(contr);
  154. if (ctr) {
  155. if (ctr->state == CAPI_CTR_RUNNING)
  156. goto unlock_out;
  157. ctr->state = CAPI_CTR_RUNNING;
  158. for (applid = 1; applid <= CAPI_MAXAPPL; applid++) {
  159. ap = __get_capi_appl_by_nr(applid);
  160. if (ap)
  161. register_appl(ctr, applid, &ap->rparam);
  162. }
  163. wake_up_interruptible_all(&ctr->state_wait_queue);
  164. } else
  165. printk(KERN_WARNING "%s: invalid contr %d\n", __func__, contr);
  166. unlock_out:
  167. mutex_unlock(&capi_controller_lock);
  168. }
  169. static void ctr_down(struct capi_ctr *ctr, int new_state)
  170. {
  171. struct capi20_appl *ap;
  172. u16 applid;
  173. if (ctr->state == CAPI_CTR_DETECTED || ctr->state == CAPI_CTR_DETACHED)
  174. return;
  175. ctr->state = new_state;
  176. memset(ctr->manu, 0, sizeof(ctr->manu));
  177. memset(&ctr->version, 0, sizeof(ctr->version));
  178. memset(&ctr->profile, 0, sizeof(ctr->profile));
  179. memset(ctr->serial, 0, sizeof(ctr->serial));
  180. for (applid = 1; applid <= CAPI_MAXAPPL; applid++) {
  181. ap = __get_capi_appl_by_nr(applid);
  182. if (ap)
  183. capi_ctr_put(ctr);
  184. }
  185. wake_up_interruptible_all(&ctr->state_wait_queue);
  186. }
  187. static void notify_down(u32 contr)
  188. {
  189. struct capi_ctr *ctr;
  190. mutex_lock(&capi_controller_lock);
  191. if (showcapimsgs & 1)
  192. printk(KERN_DEBUG "kcapi: notify down contr %d\n", contr);
  193. ctr = get_capi_ctr_by_nr(contr);
  194. if (ctr)
  195. ctr_down(ctr, CAPI_CTR_DETECTED);
  196. else
  197. printk(KERN_WARNING "%s: invalid contr %d\n", __func__, contr);
  198. mutex_unlock(&capi_controller_lock);
  199. }
  200. static int
  201. notify_handler(struct notifier_block *nb, unsigned long val, void *v)
  202. {
  203. u32 contr = (long)v;
  204. switch (val) {
  205. case CAPICTR_UP:
  206. notify_up(contr);
  207. break;
  208. case CAPICTR_DOWN:
  209. notify_down(contr);
  210. break;
  211. }
  212. return NOTIFY_OK;
  213. }
  214. static void do_notify_work(struct work_struct *work)
  215. {
  216. struct capictr_event *event =
  217. container_of(work, struct capictr_event, work);
  218. blocking_notifier_call_chain(&ctr_notifier_list, event->type,
  219. (void *)(long)event->controller);
  220. kfree(event);
  221. }
  222. /*
  223. * The notifier will result in adding/deleteing of devices. Devices can
  224. * only removed in user process, not in bh.
  225. */
  226. static int notify_push(unsigned int event_type, u32 controller)
  227. {
  228. struct capictr_event *event = kmalloc(sizeof(*event), GFP_ATOMIC);
  229. if (!event)
  230. return -ENOMEM;
  231. INIT_WORK(&event->work, do_notify_work);
  232. event->type = event_type;
  233. event->controller = controller;
  234. queue_work(kcapi_wq, &event->work);
  235. return 0;
  236. }
  237. int register_capictr_notifier(struct notifier_block *nb)
  238. {
  239. return blocking_notifier_chain_register(&ctr_notifier_list, nb);
  240. }
  241. EXPORT_SYMBOL_GPL(register_capictr_notifier);
  242. int unregister_capictr_notifier(struct notifier_block *nb)
  243. {
  244. return blocking_notifier_chain_unregister(&ctr_notifier_list, nb);
  245. }
  246. EXPORT_SYMBOL_GPL(unregister_capictr_notifier);
  247. /* -------- Receiver ------------------------------------------ */
  248. static void recv_handler(struct work_struct *work)
  249. {
  250. struct sk_buff *skb;
  251. struct capi20_appl *ap =
  252. container_of(work, struct capi20_appl, recv_work);
  253. if ((!ap) || (ap->release_in_progress))
  254. return;
  255. mutex_lock(&ap->recv_mtx);
  256. while ((skb = skb_dequeue(&ap->recv_queue))) {
  257. if (CAPIMSG_CMD(skb->data) == CAPI_DATA_B3_IND)
  258. ap->nrecvdatapkt++;
  259. else
  260. ap->nrecvctlpkt++;
  261. ap->recv_message(ap, skb);
  262. }
  263. mutex_unlock(&ap->recv_mtx);
  264. }
  265. /**
  266. * capi_ctr_handle_message() - handle incoming CAPI message
  267. * @ctr: controller descriptor structure.
  268. * @appl: application ID.
  269. * @skb: message.
  270. *
  271. * Called by hardware driver to pass a CAPI message to the application.
  272. */
  273. void capi_ctr_handle_message(struct capi_ctr *ctr, u16 appl,
  274. struct sk_buff *skb)
  275. {
  276. struct capi20_appl *ap;
  277. int showctl = 0;
  278. u8 cmd, subcmd;
  279. _cdebbuf *cdb;
  280. if (ctr->state != CAPI_CTR_RUNNING) {
  281. cdb = capi_message2str(skb->data);
  282. if (cdb) {
  283. printk(KERN_INFO "kcapi: controller [%03d] not active, got: %s",
  284. ctr->cnr, cdb->buf);
  285. cdebbuf_free(cdb);
  286. } else
  287. printk(KERN_INFO "kcapi: controller [%03d] not active, cannot trace\n",
  288. ctr->cnr);
  289. goto error;
  290. }
  291. cmd = CAPIMSG_COMMAND(skb->data);
  292. subcmd = CAPIMSG_SUBCOMMAND(skb->data);
  293. if (cmd == CAPI_DATA_B3 && subcmd == CAPI_IND) {
  294. ctr->nrecvdatapkt++;
  295. if (ctr->traceflag > 2)
  296. showctl |= 2;
  297. } else {
  298. ctr->nrecvctlpkt++;
  299. if (ctr->traceflag)
  300. showctl |= 2;
  301. }
  302. showctl |= (ctr->traceflag & 1);
  303. if (showctl & 2) {
  304. if (showctl & 1) {
  305. printk(KERN_DEBUG "kcapi: got [%03d] id#%d %s len=%u\n",
  306. ctr->cnr, CAPIMSG_APPID(skb->data),
  307. capi_cmd2str(cmd, subcmd),
  308. CAPIMSG_LEN(skb->data));
  309. } else {
  310. cdb = capi_message2str(skb->data);
  311. if (cdb) {
  312. printk(KERN_DEBUG "kcapi: got [%03d] %s\n",
  313. ctr->cnr, cdb->buf);
  314. cdebbuf_free(cdb);
  315. } else
  316. printk(KERN_DEBUG "kcapi: got [%03d] id#%d %s len=%u, cannot trace\n",
  317. ctr->cnr, CAPIMSG_APPID(skb->data),
  318. capi_cmd2str(cmd, subcmd),
  319. CAPIMSG_LEN(skb->data));
  320. }
  321. }
  322. rcu_read_lock();
  323. ap = get_capi_appl_by_nr(CAPIMSG_APPID(skb->data));
  324. if (!ap) {
  325. rcu_read_unlock();
  326. cdb = capi_message2str(skb->data);
  327. if (cdb) {
  328. printk(KERN_ERR "kcapi: handle_message: applid %d state released (%s)\n",
  329. CAPIMSG_APPID(skb->data), cdb->buf);
  330. cdebbuf_free(cdb);
  331. } else
  332. printk(KERN_ERR "kcapi: handle_message: applid %d state released (%s) cannot trace\n",
  333. CAPIMSG_APPID(skb->data),
  334. capi_cmd2str(cmd, subcmd));
  335. goto error;
  336. }
  337. skb_queue_tail(&ap->recv_queue, skb);
  338. queue_work(kcapi_wq, &ap->recv_work);
  339. rcu_read_unlock();
  340. return;
  341. error:
  342. kfree_skb(skb);
  343. }
  344. EXPORT_SYMBOL(capi_ctr_handle_message);
  345. /**
  346. * capi_ctr_ready() - signal CAPI controller ready
  347. * @ctr: controller descriptor structure.
  348. *
  349. * Called by hardware driver to signal that the controller is up and running.
  350. */
  351. void capi_ctr_ready(struct capi_ctr *ctr)
  352. {
  353. printk(KERN_NOTICE "kcapi: controller [%03d] \"%s\" ready.\n",
  354. ctr->cnr, ctr->name);
  355. notify_push(CAPICTR_UP, ctr->cnr);
  356. }
  357. EXPORT_SYMBOL(capi_ctr_ready);
  358. /**
  359. * capi_ctr_down() - signal CAPI controller not ready
  360. * @ctr: controller descriptor structure.
  361. *
  362. * Called by hardware driver to signal that the controller is down and
  363. * unavailable for use.
  364. */
  365. void capi_ctr_down(struct capi_ctr *ctr)
  366. {
  367. printk(KERN_NOTICE "kcapi: controller [%03d] down.\n", ctr->cnr);
  368. notify_push(CAPICTR_DOWN, ctr->cnr);
  369. }
  370. EXPORT_SYMBOL(capi_ctr_down);
  371. /**
  372. * capi_ctr_suspend_output() - suspend controller
  373. * @ctr: controller descriptor structure.
  374. *
  375. * Called by hardware driver to stop data flow.
  376. *
  377. * Note: The caller is responsible for synchronizing concurrent state changes
  378. * as well as invocations of capi_ctr_handle_message.
  379. */
  380. void capi_ctr_suspend_output(struct capi_ctr *ctr)
  381. {
  382. if (!ctr->blocked) {
  383. printk(KERN_DEBUG "kcapi: controller [%03d] suspend\n",
  384. ctr->cnr);
  385. ctr->blocked = 1;
  386. }
  387. }
  388. EXPORT_SYMBOL(capi_ctr_suspend_output);
  389. /**
  390. * capi_ctr_resume_output() - resume controller
  391. * @ctr: controller descriptor structure.
  392. *
  393. * Called by hardware driver to resume data flow.
  394. *
  395. * Note: The caller is responsible for synchronizing concurrent state changes
  396. * as well as invocations of capi_ctr_handle_message.
  397. */
  398. void capi_ctr_resume_output(struct capi_ctr *ctr)
  399. {
  400. if (ctr->blocked) {
  401. printk(KERN_DEBUG "kcapi: controller [%03d] resumed\n",
  402. ctr->cnr);
  403. ctr->blocked = 0;
  404. }
  405. }
  406. EXPORT_SYMBOL(capi_ctr_resume_output);
  407. /* ------------------------------------------------------------- */
  408. /**
  409. * attach_capi_ctr() - register CAPI controller
  410. * @ctr: controller descriptor structure.
  411. *
  412. * Called by hardware driver to register a controller with the CAPI subsystem.
  413. * Return value: 0 on success, error code < 0 on error
  414. */
  415. int attach_capi_ctr(struct capi_ctr *ctr)
  416. {
  417. int i;
  418. mutex_lock(&capi_controller_lock);
  419. for (i = 0; i < CAPI_MAXCONTR; i++) {
  420. if (!capi_controller[i])
  421. break;
  422. }
  423. if (i == CAPI_MAXCONTR) {
  424. mutex_unlock(&capi_controller_lock);
  425. printk(KERN_ERR "kcapi: out of controller slots\n");
  426. return -EBUSY;
  427. }
  428. capi_controller[i] = ctr;
  429. ctr->nrecvctlpkt = 0;
  430. ctr->nrecvdatapkt = 0;
  431. ctr->nsentctlpkt = 0;
  432. ctr->nsentdatapkt = 0;
  433. ctr->cnr = i + 1;
  434. ctr->state = CAPI_CTR_DETECTED;
  435. ctr->blocked = 0;
  436. ctr->traceflag = showcapimsgs;
  437. init_waitqueue_head(&ctr->state_wait_queue);
  438. sprintf(ctr->procfn, "capi/controllers/%d", ctr->cnr);
  439. ctr->procent = proc_create_single_data(ctr->procfn, 0, NULL,
  440. ctr->proc_show, ctr);
  441. ncontrollers++;
  442. mutex_unlock(&capi_controller_lock);
  443. printk(KERN_NOTICE "kcapi: controller [%03d]: %s attached\n",
  444. ctr->cnr, ctr->name);
  445. return 0;
  446. }
  447. EXPORT_SYMBOL(attach_capi_ctr);
  448. /**
  449. * detach_capi_ctr() - unregister CAPI controller
  450. * @ctr: controller descriptor structure.
  451. *
  452. * Called by hardware driver to remove the registration of a controller
  453. * with the CAPI subsystem.
  454. * Return value: 0 on success, error code < 0 on error
  455. */
  456. int detach_capi_ctr(struct capi_ctr *ctr)
  457. {
  458. int err = 0;
  459. mutex_lock(&capi_controller_lock);
  460. ctr_down(ctr, CAPI_CTR_DETACHED);
  461. if (capi_controller[ctr->cnr - 1] != ctr) {
  462. err = -EINVAL;
  463. goto unlock_out;
  464. }
  465. capi_controller[ctr->cnr - 1] = NULL;
  466. ncontrollers--;
  467. if (ctr->procent)
  468. remove_proc_entry(ctr->procfn, NULL);
  469. printk(KERN_NOTICE "kcapi: controller [%03d]: %s unregistered\n",
  470. ctr->cnr, ctr->name);
  471. unlock_out:
  472. mutex_unlock(&capi_controller_lock);
  473. return err;
  474. }
  475. EXPORT_SYMBOL(detach_capi_ctr);
  476. /**
  477. * register_capi_driver() - register CAPI driver
  478. * @driver: driver descriptor structure.
  479. *
  480. * Called by hardware driver to register itself with the CAPI subsystem.
  481. */
  482. void register_capi_driver(struct capi_driver *driver)
  483. {
  484. mutex_lock(&capi_drivers_lock);
  485. list_add_tail(&driver->list, &capi_drivers);
  486. mutex_unlock(&capi_drivers_lock);
  487. }
  488. EXPORT_SYMBOL(register_capi_driver);
  489. /**
  490. * unregister_capi_driver() - unregister CAPI driver
  491. * @driver: driver descriptor structure.
  492. *
  493. * Called by hardware driver to unregister itself from the CAPI subsystem.
  494. */
  495. void unregister_capi_driver(struct capi_driver *driver)
  496. {
  497. mutex_lock(&capi_drivers_lock);
  498. list_del(&driver->list);
  499. mutex_unlock(&capi_drivers_lock);
  500. }
  501. EXPORT_SYMBOL(unregister_capi_driver);
  502. /* ------------------------------------------------------------- */
  503. /* -------- CAPI2.0 Interface ---------------------------------- */
  504. /* ------------------------------------------------------------- */
  505. /**
  506. * capi20_isinstalled() - CAPI 2.0 operation CAPI_INSTALLED
  507. *
  508. * Return value: CAPI result code (CAPI_NOERROR if at least one ISDN controller
  509. * is ready for use, CAPI_REGNOTINSTALLED otherwise)
  510. */
  511. u16 capi20_isinstalled(void)
  512. {
  513. u16 ret = CAPI_REGNOTINSTALLED;
  514. int i;
  515. mutex_lock(&capi_controller_lock);
  516. for (i = 0; i < CAPI_MAXCONTR; i++)
  517. if (capi_controller[i] &&
  518. capi_controller[i]->state == CAPI_CTR_RUNNING) {
  519. ret = CAPI_NOERROR;
  520. break;
  521. }
  522. mutex_unlock(&capi_controller_lock);
  523. return ret;
  524. }
  525. EXPORT_SYMBOL(capi20_isinstalled);
  526. /**
  527. * capi20_register() - CAPI 2.0 operation CAPI_REGISTER
  528. * @ap: CAPI application descriptor structure.
  529. *
  530. * Register an application's presence with CAPI.
  531. * A unique application ID is assigned and stored in @ap->applid.
  532. * After this function returns successfully, the message receive
  533. * callback function @ap->recv_message() may be called at any time
  534. * until capi20_release() has been called for the same @ap.
  535. * Return value: CAPI result code
  536. */
  537. u16 capi20_register(struct capi20_appl *ap)
  538. {
  539. int i;
  540. u16 applid;
  541. DBG("");
  542. if (ap->rparam.datablklen < 128)
  543. return CAPI_LOGBLKSIZETOSMALL;
  544. ap->nrecvctlpkt = 0;
  545. ap->nrecvdatapkt = 0;
  546. ap->nsentctlpkt = 0;
  547. ap->nsentdatapkt = 0;
  548. mutex_init(&ap->recv_mtx);
  549. skb_queue_head_init(&ap->recv_queue);
  550. INIT_WORK(&ap->recv_work, recv_handler);
  551. ap->release_in_progress = 0;
  552. mutex_lock(&capi_controller_lock);
  553. for (applid = 1; applid <= CAPI_MAXAPPL; applid++) {
  554. if (capi_applications[applid - 1] == NULL)
  555. break;
  556. }
  557. if (applid > CAPI_MAXAPPL) {
  558. mutex_unlock(&capi_controller_lock);
  559. return CAPI_TOOMANYAPPLS;
  560. }
  561. ap->applid = applid;
  562. capi_applications[applid - 1] = ap;
  563. for (i = 0; i < CAPI_MAXCONTR; i++) {
  564. if (!capi_controller[i] ||
  565. capi_controller[i]->state != CAPI_CTR_RUNNING)
  566. continue;
  567. register_appl(capi_controller[i], applid, &ap->rparam);
  568. }
  569. mutex_unlock(&capi_controller_lock);
  570. if (showcapimsgs & 1) {
  571. printk(KERN_DEBUG "kcapi: appl %d up\n", applid);
  572. }
  573. return CAPI_NOERROR;
  574. }
  575. EXPORT_SYMBOL(capi20_register);
  576. /**
  577. * capi20_release() - CAPI 2.0 operation CAPI_RELEASE
  578. * @ap: CAPI application descriptor structure.
  579. *
  580. * Terminate an application's registration with CAPI.
  581. * After this function returns successfully, the message receive
  582. * callback function @ap->recv_message() will no longer be called.
  583. * Return value: CAPI result code
  584. */
  585. u16 capi20_release(struct capi20_appl *ap)
  586. {
  587. int i;
  588. DBG("applid %#x", ap->applid);
  589. mutex_lock(&capi_controller_lock);
  590. ap->release_in_progress = 1;
  591. capi_applications[ap->applid - 1] = NULL;
  592. synchronize_rcu();
  593. for (i = 0; i < CAPI_MAXCONTR; i++) {
  594. if (!capi_controller[i] ||
  595. capi_controller[i]->state != CAPI_CTR_RUNNING)
  596. continue;
  597. release_appl(capi_controller[i], ap->applid);
  598. }
  599. mutex_unlock(&capi_controller_lock);
  600. flush_workqueue(kcapi_wq);
  601. skb_queue_purge(&ap->recv_queue);
  602. if (showcapimsgs & 1) {
  603. printk(KERN_DEBUG "kcapi: appl %d down\n", ap->applid);
  604. }
  605. return CAPI_NOERROR;
  606. }
  607. EXPORT_SYMBOL(capi20_release);
  608. /**
  609. * capi20_put_message() - CAPI 2.0 operation CAPI_PUT_MESSAGE
  610. * @ap: CAPI application descriptor structure.
  611. * @skb: CAPI message.
  612. *
  613. * Transfer a single message to CAPI.
  614. * Return value: CAPI result code
  615. */
  616. u16 capi20_put_message(struct capi20_appl *ap, struct sk_buff *skb)
  617. {
  618. struct capi_ctr *ctr;
  619. int showctl = 0;
  620. u8 cmd, subcmd;
  621. DBG("applid %#x", ap->applid);
  622. if (ncontrollers == 0)
  623. return CAPI_REGNOTINSTALLED;
  624. if ((ap->applid == 0) || ap->release_in_progress)
  625. return CAPI_ILLAPPNR;
  626. if (skb->len < 12
  627. || !capi_cmd_valid(CAPIMSG_COMMAND(skb->data))
  628. || !capi_subcmd_valid(CAPIMSG_SUBCOMMAND(skb->data)))
  629. return CAPI_ILLCMDORSUBCMDORMSGTOSMALL;
  630. /*
  631. * The controller reference is protected by the existence of the
  632. * application passed to us. We assume that the caller properly
  633. * synchronizes this service with capi20_release.
  634. */
  635. ctr = get_capi_ctr_by_nr(CAPIMSG_CONTROLLER(skb->data));
  636. if (!ctr || ctr->state != CAPI_CTR_RUNNING)
  637. return CAPI_REGNOTINSTALLED;
  638. if (ctr->blocked)
  639. return CAPI_SENDQUEUEFULL;
  640. cmd = CAPIMSG_COMMAND(skb->data);
  641. subcmd = CAPIMSG_SUBCOMMAND(skb->data);
  642. if (cmd == CAPI_DATA_B3 && subcmd == CAPI_REQ) {
  643. ctr->nsentdatapkt++;
  644. ap->nsentdatapkt++;
  645. if (ctr->traceflag > 2)
  646. showctl |= 2;
  647. } else {
  648. ctr->nsentctlpkt++;
  649. ap->nsentctlpkt++;
  650. if (ctr->traceflag)
  651. showctl |= 2;
  652. }
  653. showctl |= (ctr->traceflag & 1);
  654. if (showctl & 2) {
  655. if (showctl & 1) {
  656. printk(KERN_DEBUG "kcapi: put [%03d] id#%d %s len=%u\n",
  657. CAPIMSG_CONTROLLER(skb->data),
  658. CAPIMSG_APPID(skb->data),
  659. capi_cmd2str(cmd, subcmd),
  660. CAPIMSG_LEN(skb->data));
  661. } else {
  662. _cdebbuf *cdb = capi_message2str(skb->data);
  663. if (cdb) {
  664. printk(KERN_DEBUG "kcapi: put [%03d] %s\n",
  665. CAPIMSG_CONTROLLER(skb->data),
  666. cdb->buf);
  667. cdebbuf_free(cdb);
  668. } else
  669. printk(KERN_DEBUG "kcapi: put [%03d] id#%d %s len=%u cannot trace\n",
  670. CAPIMSG_CONTROLLER(skb->data),
  671. CAPIMSG_APPID(skb->data),
  672. capi_cmd2str(cmd, subcmd),
  673. CAPIMSG_LEN(skb->data));
  674. }
  675. }
  676. return ctr->send_message(ctr, skb);
  677. }
  678. EXPORT_SYMBOL(capi20_put_message);
  679. /**
  680. * capi20_get_manufacturer() - CAPI 2.0 operation CAPI_GET_MANUFACTURER
  681. * @contr: controller number.
  682. * @buf: result buffer (64 bytes).
  683. *
  684. * Retrieve information about the manufacturer of the specified ISDN controller
  685. * or (for @contr == 0) the driver itself.
  686. * Return value: CAPI result code
  687. */
  688. u16 capi20_get_manufacturer(u32 contr, u8 buf[CAPI_MANUFACTURER_LEN])
  689. {
  690. struct capi_ctr *ctr;
  691. u16 ret;
  692. if (contr == 0) {
  693. strncpy(buf, capi_manufakturer, CAPI_MANUFACTURER_LEN);
  694. return CAPI_NOERROR;
  695. }
  696. mutex_lock(&capi_controller_lock);
  697. ctr = get_capi_ctr_by_nr(contr);
  698. if (ctr && ctr->state == CAPI_CTR_RUNNING) {
  699. strncpy(buf, ctr->manu, CAPI_MANUFACTURER_LEN);
  700. ret = CAPI_NOERROR;
  701. } else
  702. ret = CAPI_REGNOTINSTALLED;
  703. mutex_unlock(&capi_controller_lock);
  704. return ret;
  705. }
  706. EXPORT_SYMBOL(capi20_get_manufacturer);
  707. /**
  708. * capi20_get_version() - CAPI 2.0 operation CAPI_GET_VERSION
  709. * @contr: controller number.
  710. * @verp: result structure.
  711. *
  712. * Retrieve version information for the specified ISDN controller
  713. * or (for @contr == 0) the driver itself.
  714. * Return value: CAPI result code
  715. */
  716. u16 capi20_get_version(u32 contr, struct capi_version *verp)
  717. {
  718. struct capi_ctr *ctr;
  719. u16 ret;
  720. if (contr == 0) {
  721. *verp = driver_version;
  722. return CAPI_NOERROR;
  723. }
  724. mutex_lock(&capi_controller_lock);
  725. ctr = get_capi_ctr_by_nr(contr);
  726. if (ctr && ctr->state == CAPI_CTR_RUNNING) {
  727. memcpy(verp, &ctr->version, sizeof(capi_version));
  728. ret = CAPI_NOERROR;
  729. } else
  730. ret = CAPI_REGNOTINSTALLED;
  731. mutex_unlock(&capi_controller_lock);
  732. return ret;
  733. }
  734. EXPORT_SYMBOL(capi20_get_version);
  735. /**
  736. * capi20_get_serial() - CAPI 2.0 operation CAPI_GET_SERIAL_NUMBER
  737. * @contr: controller number.
  738. * @serial: result buffer (8 bytes).
  739. *
  740. * Retrieve the serial number of the specified ISDN controller
  741. * or (for @contr == 0) the driver itself.
  742. * Return value: CAPI result code
  743. */
  744. u16 capi20_get_serial(u32 contr, u8 serial[CAPI_SERIAL_LEN])
  745. {
  746. struct capi_ctr *ctr;
  747. u16 ret;
  748. if (contr == 0) {
  749. strlcpy(serial, driver_serial, CAPI_SERIAL_LEN);
  750. return CAPI_NOERROR;
  751. }
  752. mutex_lock(&capi_controller_lock);
  753. ctr = get_capi_ctr_by_nr(contr);
  754. if (ctr && ctr->state == CAPI_CTR_RUNNING) {
  755. strlcpy(serial, ctr->serial, CAPI_SERIAL_LEN);
  756. ret = CAPI_NOERROR;
  757. } else
  758. ret = CAPI_REGNOTINSTALLED;
  759. mutex_unlock(&capi_controller_lock);
  760. return ret;
  761. }
  762. EXPORT_SYMBOL(capi20_get_serial);
  763. /**
  764. * capi20_get_profile() - CAPI 2.0 operation CAPI_GET_PROFILE
  765. * @contr: controller number.
  766. * @profp: result structure.
  767. *
  768. * Retrieve capability information for the specified ISDN controller
  769. * or (for @contr == 0) the number of installed controllers.
  770. * Return value: CAPI result code
  771. */
  772. u16 capi20_get_profile(u32 contr, struct capi_profile *profp)
  773. {
  774. struct capi_ctr *ctr;
  775. u16 ret;
  776. if (contr == 0) {
  777. profp->ncontroller = ncontrollers;
  778. return CAPI_NOERROR;
  779. }
  780. mutex_lock(&capi_controller_lock);
  781. ctr = get_capi_ctr_by_nr(contr);
  782. if (ctr && ctr->state == CAPI_CTR_RUNNING) {
  783. memcpy(profp, &ctr->profile, sizeof(struct capi_profile));
  784. ret = CAPI_NOERROR;
  785. } else
  786. ret = CAPI_REGNOTINSTALLED;
  787. mutex_unlock(&capi_controller_lock);
  788. return ret;
  789. }
  790. EXPORT_SYMBOL(capi20_get_profile);
  791. /* Must be called with capi_controller_lock held. */
  792. static int wait_on_ctr_state(struct capi_ctr *ctr, unsigned int state)
  793. {
  794. DEFINE_WAIT(wait);
  795. int retval = 0;
  796. ctr = capi_ctr_get(ctr);
  797. if (!ctr)
  798. return -ESRCH;
  799. for (;;) {
  800. prepare_to_wait(&ctr->state_wait_queue, &wait,
  801. TASK_INTERRUPTIBLE);
  802. if (ctr->state == state)
  803. break;
  804. if (ctr->state == CAPI_CTR_DETACHED) {
  805. retval = -ESRCH;
  806. break;
  807. }
  808. if (signal_pending(current)) {
  809. retval = -EINTR;
  810. break;
  811. }
  812. mutex_unlock(&capi_controller_lock);
  813. schedule();
  814. mutex_lock(&capi_controller_lock);
  815. }
  816. finish_wait(&ctr->state_wait_queue, &wait);
  817. capi_ctr_put(ctr);
  818. return retval;
  819. }
  820. #ifdef AVMB1_COMPAT
  821. static int old_capi_manufacturer(unsigned int cmd, void __user *data)
  822. {
  823. avmb1_loadandconfigdef ldef;
  824. avmb1_extcarddef cdef;
  825. avmb1_resetdef rdef;
  826. capicardparams cparams;
  827. struct capi_ctr *ctr;
  828. struct capi_driver *driver = NULL;
  829. capiloaddata ldata;
  830. struct list_head *l;
  831. int retval;
  832. switch (cmd) {
  833. case AVMB1_ADDCARD:
  834. case AVMB1_ADDCARD_WITH_TYPE:
  835. if (cmd == AVMB1_ADDCARD) {
  836. if ((retval = copy_from_user(&cdef, data,
  837. sizeof(avmb1_carddef))))
  838. return -EFAULT;
  839. cdef.cardtype = AVM_CARDTYPE_B1;
  840. cdef.cardnr = 0;
  841. } else {
  842. if ((retval = copy_from_user(&cdef, data,
  843. sizeof(avmb1_extcarddef))))
  844. return -EFAULT;
  845. }
  846. cparams.port = cdef.port;
  847. cparams.irq = cdef.irq;
  848. cparams.cardnr = cdef.cardnr;
  849. mutex_lock(&capi_drivers_lock);
  850. switch (cdef.cardtype) {
  851. case AVM_CARDTYPE_B1:
  852. list_for_each(l, &capi_drivers) {
  853. driver = list_entry(l, struct capi_driver, list);
  854. if (strcmp(driver->name, "b1isa") == 0)
  855. break;
  856. }
  857. break;
  858. case AVM_CARDTYPE_T1:
  859. list_for_each(l, &capi_drivers) {
  860. driver = list_entry(l, struct capi_driver, list);
  861. if (strcmp(driver->name, "t1isa") == 0)
  862. break;
  863. }
  864. break;
  865. default:
  866. driver = NULL;
  867. break;
  868. }
  869. if (!driver) {
  870. printk(KERN_ERR "kcapi: driver not loaded.\n");
  871. retval = -EIO;
  872. } else if (!driver->add_card) {
  873. printk(KERN_ERR "kcapi: driver has no add card function.\n");
  874. retval = -EIO;
  875. } else
  876. retval = driver->add_card(driver, &cparams);
  877. mutex_unlock(&capi_drivers_lock);
  878. return retval;
  879. case AVMB1_LOAD:
  880. case AVMB1_LOAD_AND_CONFIG:
  881. if (cmd == AVMB1_LOAD) {
  882. if (copy_from_user(&ldef, data,
  883. sizeof(avmb1_loaddef)))
  884. return -EFAULT;
  885. ldef.t4config.len = 0;
  886. ldef.t4config.data = NULL;
  887. } else {
  888. if (copy_from_user(&ldef, data,
  889. sizeof(avmb1_loadandconfigdef)))
  890. return -EFAULT;
  891. }
  892. mutex_lock(&capi_controller_lock);
  893. ctr = get_capi_ctr_by_nr(ldef.contr);
  894. if (!ctr) {
  895. retval = -EINVAL;
  896. goto load_unlock_out;
  897. }
  898. if (ctr->load_firmware == NULL) {
  899. printk(KERN_DEBUG "kcapi: load: no load function\n");
  900. retval = -ESRCH;
  901. goto load_unlock_out;
  902. }
  903. if (ldef.t4file.len <= 0) {
  904. printk(KERN_DEBUG "kcapi: load: invalid parameter: length of t4file is %d ?\n", ldef.t4file.len);
  905. retval = -EINVAL;
  906. goto load_unlock_out;
  907. }
  908. if (ldef.t4file.data == NULL) {
  909. printk(KERN_DEBUG "kcapi: load: invalid parameter: dataptr is 0\n");
  910. retval = -EINVAL;
  911. goto load_unlock_out;
  912. }
  913. ldata.firmware.user = 1;
  914. ldata.firmware.data = ldef.t4file.data;
  915. ldata.firmware.len = ldef.t4file.len;
  916. ldata.configuration.user = 1;
  917. ldata.configuration.data = ldef.t4config.data;
  918. ldata.configuration.len = ldef.t4config.len;
  919. if (ctr->state != CAPI_CTR_DETECTED) {
  920. printk(KERN_INFO "kcapi: load: contr=%d not in detect state\n", ldef.contr);
  921. retval = -EBUSY;
  922. goto load_unlock_out;
  923. }
  924. ctr->state = CAPI_CTR_LOADING;
  925. retval = ctr->load_firmware(ctr, &ldata);
  926. if (retval) {
  927. ctr->state = CAPI_CTR_DETECTED;
  928. goto load_unlock_out;
  929. }
  930. retval = wait_on_ctr_state(ctr, CAPI_CTR_RUNNING);
  931. load_unlock_out:
  932. mutex_unlock(&capi_controller_lock);
  933. return retval;
  934. case AVMB1_RESETCARD:
  935. if (copy_from_user(&rdef, data, sizeof(avmb1_resetdef)))
  936. return -EFAULT;
  937. retval = 0;
  938. mutex_lock(&capi_controller_lock);
  939. ctr = get_capi_ctr_by_nr(rdef.contr);
  940. if (!ctr) {
  941. retval = -ESRCH;
  942. goto reset_unlock_out;
  943. }
  944. if (ctr->state == CAPI_CTR_DETECTED)
  945. goto reset_unlock_out;
  946. if (ctr->reset_ctr == NULL) {
  947. printk(KERN_DEBUG "kcapi: reset: no reset function\n");
  948. retval = -ESRCH;
  949. goto reset_unlock_out;
  950. }
  951. ctr->reset_ctr(ctr);
  952. retval = wait_on_ctr_state(ctr, CAPI_CTR_DETECTED);
  953. reset_unlock_out:
  954. mutex_unlock(&capi_controller_lock);
  955. return retval;
  956. }
  957. return -EINVAL;
  958. }
  959. #endif
  960. /**
  961. * capi20_manufacturer() - CAPI 2.0 operation CAPI_MANUFACTURER
  962. * @cmd: command.
  963. * @data: parameter.
  964. *
  965. * Perform manufacturer specific command.
  966. * Return value: CAPI result code
  967. */
  968. int capi20_manufacturer(unsigned long cmd, void __user *data)
  969. {
  970. struct capi_ctr *ctr;
  971. int retval;
  972. switch (cmd) {
  973. #ifdef AVMB1_COMPAT
  974. case AVMB1_LOAD:
  975. case AVMB1_LOAD_AND_CONFIG:
  976. case AVMB1_RESETCARD:
  977. case AVMB1_GET_CARDINFO:
  978. case AVMB1_REMOVECARD:
  979. return old_capi_manufacturer(cmd, data);
  980. #endif
  981. case KCAPI_CMD_TRACE:
  982. {
  983. kcapi_flagdef fdef;
  984. if (copy_from_user(&fdef, data, sizeof(kcapi_flagdef)))
  985. return -EFAULT;
  986. mutex_lock(&capi_controller_lock);
  987. ctr = get_capi_ctr_by_nr(fdef.contr);
  988. if (ctr) {
  989. ctr->traceflag = fdef.flag;
  990. printk(KERN_INFO "kcapi: contr [%03d] set trace=%d\n",
  991. ctr->cnr, ctr->traceflag);
  992. retval = 0;
  993. } else
  994. retval = -ESRCH;
  995. mutex_unlock(&capi_controller_lock);
  996. return retval;
  997. }
  998. case KCAPI_CMD_ADDCARD:
  999. {
  1000. struct list_head *l;
  1001. struct capi_driver *driver = NULL;
  1002. capicardparams cparams;
  1003. kcapi_carddef cdef;
  1004. if ((retval = copy_from_user(&cdef, data, sizeof(cdef))))
  1005. return -EFAULT;
  1006. cparams.port = cdef.port;
  1007. cparams.irq = cdef.irq;
  1008. cparams.membase = cdef.membase;
  1009. cparams.cardnr = cdef.cardnr;
  1010. cparams.cardtype = 0;
  1011. cdef.driver[sizeof(cdef.driver) - 1] = 0;
  1012. mutex_lock(&capi_drivers_lock);
  1013. list_for_each(l, &capi_drivers) {
  1014. driver = list_entry(l, struct capi_driver, list);
  1015. if (strcmp(driver->name, cdef.driver) == 0)
  1016. break;
  1017. }
  1018. if (driver == NULL) {
  1019. printk(KERN_ERR "kcapi: driver \"%s\" not loaded.\n",
  1020. cdef.driver);
  1021. retval = -ESRCH;
  1022. } else if (!driver->add_card) {
  1023. printk(KERN_ERR "kcapi: driver \"%s\" has no add card function.\n", cdef.driver);
  1024. retval = -EIO;
  1025. } else
  1026. retval = driver->add_card(driver, &cparams);
  1027. mutex_unlock(&capi_drivers_lock);
  1028. return retval;
  1029. }
  1030. default:
  1031. printk(KERN_ERR "kcapi: manufacturer command %lu unknown.\n",
  1032. cmd);
  1033. break;
  1034. }
  1035. return -EINVAL;
  1036. }
  1037. EXPORT_SYMBOL(capi20_manufacturer);
  1038. /* ------------------------------------------------------------- */
  1039. /* -------- Init & Cleanup ------------------------------------- */
  1040. /* ------------------------------------------------------------- */
  1041. /*
  1042. * init / exit functions
  1043. */
  1044. static struct notifier_block capictr_nb = {
  1045. .notifier_call = notify_handler,
  1046. .priority = INT_MAX,
  1047. };
  1048. static int __init kcapi_init(void)
  1049. {
  1050. int err;
  1051. kcapi_wq = alloc_workqueue("kcapi", 0, 0);
  1052. if (!kcapi_wq)
  1053. return -ENOMEM;
  1054. register_capictr_notifier(&capictr_nb);
  1055. err = cdebug_init();
  1056. if (err) {
  1057. unregister_capictr_notifier(&capictr_nb);
  1058. destroy_workqueue(kcapi_wq);
  1059. return err;
  1060. }
  1061. kcapi_proc_init();
  1062. return 0;
  1063. }
  1064. static void __exit kcapi_exit(void)
  1065. {
  1066. kcapi_proc_exit();
  1067. unregister_capictr_notifier(&capictr_nb);
  1068. cdebug_exit();
  1069. destroy_workqueue(kcapi_wq);
  1070. }
  1071. module_init(kcapi_init);
  1072. module_exit(kcapi_exit);