home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 March B / SCO_CASTOR4RRT.iso / frle / root.1 / usr / lib / locale / fr / LC_MESSAGES / dbg.help.thr / dbg.help
Text File  |  1998-08-19  |  89KB  |  2,536 lines
  1. # This file contains the help messages used by the Command Line interface.
  2. # Each help message is bracketed by lines starting with ++.
  3. # The debugger does not depend on the size (number of lines) of any message,
  4. # but it does depend on the order of the messages.  New messages MUST be
  5. # added to the end of the file.
  6.  
  7. # This version is for the version of debug that supports threads
  8.  
  9. ++ !
  10. NOM
  11. ! - exΘcution d'une commande shell.
  12.  
  13. RESUME
  14. ! cmd_line 
  15. !!
  16.  
  17. DESCRIPTION
  18. ExΘcute une commande shell. Le reste de la ligne est transmis au shell
  19. pour Ωtre interprΘtΘ. En particulier, les donnΘes ne sont PAS redirigΘes
  20. par le dΘbogueur mais par le shell. La variable $SHELL, lorsqu'elle est
  21. dΘfinie, comporte le chemin d'accΦs complet du shell α utiliser. Si
  22. $SHELL n'est pas dΘfinie, c'est /usr/bin/sh qui est employΘ. Le
  23. dΘbogueur attend que la commande s'achΦve, mais ne prend pas le
  24. contr⌠le des processus rΘsultants.
  25.  
  26. !! indique que la derniΦre commande shell doit Ωtre rΘexΘcutΘe.
  27.  
  28. VOIR EGALEMENT
  29. create, redirection
  30. ++
  31.  
  32. ++ alias
  33. NOM
  34. alias - ajout, recencement ou suppression des alias.
  35.  
  36. RESUME
  37. jetons des noms d'alias ...
  38. alias [nom]
  39. alias -r nom
  40.  
  41. DESCRIPTION
  42. La premiΦre forme crΘe un alias "nom" pour les "jetons". Tous les
  43. caractΦres qui se trouvent avant le retour chariot ou le commentaire
  44. seront considΘrΘs comme faisant partie de la dΘfinition. Les alias
  45. existants ou les commandes dΘbogueur peuvent Ωtre redΘfinis sous un nom
  46. d'alias. Une fois que cette dΘfinition est effectuΘe, l'utilisation de
  47. l'alias Θquivaut α taper la sΘquence de symboles qu'il remplace. Les
  48. alias peuvent Ωtre dΘfinis par d'autres alias, mais non de faτon
  49. rΘcursive.
  50.  
  51. Les dΘfinitions d'alias peuvent contenir les identificateurs spΘciaux
  52. $1, $2,... Chacun de ces identificateurs spΘciaux $n est remplacΘ, dans
  53. une dΘfinition d'alias, par le ΘniΦme argument de l'appel d'alias, les
  54. arguments Θtant classΘs par ordre croissant α partir de 1. Chaque
  55. argument doit Ωtre prΘcΘdΘ par un espace blanc et se terminer par un
  56. espace, un caractΦre d'interligne, le caractΦre de commentaire (#) ou
  57. le dΘbut d'un bloc ({). Les identificateurs spΘciaux $1, $2, ... ne
  58. seront pas remplacΘs α l'intΘrieur d'une chaεne entre guillemets.
  59.  
  60. Si la dΘfinition d'un alias comporte l'identificateur spΘcial $#, au
  61. cours de l'appel de l'alias, celui-ci sera remplacΘ par le nombre
  62. d'arguments qui interviennent effectivement dans cet appel. Si la
  63. dΘfinition de l'alias comporte l'identificateur spΘcial $*, au cours de
  64. l'appel de l'alias, celui-ci sera remplacΘ par une liste de tous les
  65. arguments transmis au cours de cet appel, chaque argument Θtant sΘparΘ
  66. des autres par un espace.
  67.  
  68. S'il n'y a pas d'arguments, la commande alias affiche la liste de tous
  69. les alias actuels. S'il y a un seul nom, l'alias correspondant
  70. s'affiche.
  71.  
  72. L'option -r de la commande alias supprime tous les alias correspondants
  73. au nom indiquΘ.
  74.  
  75. EXEMPLES
  76. alias
  77. alias i
  78. alias i step -i
  79. alias edit list $1@1
  80. alias print_list while($1) { print *$1; set $1 = $1->next }
  81. alias b if ($# > 0) { stop $* } else { stop %list_file@%list_line }
  82. alias -r i
  83. ++
  84.  
  85. ++ stop
  86. NOM
  87. stop - dΘfinition ou affichage des ΘvΘnements stop.
  88.  
  89. RESUME
  90. stop [-p liste_proc] [[-q] [-c nombre] expr_stop [commande]]
  91. stop [-p liste_proc]
  92.  
  93. DESCRIPTION
  94. Un ΘvΘnement stop spΘcifie une condition de l'espace adresse d'un
  95. programme qui induit le dΘbogueur α arrΩter l'exΘcution du programme.
  96. "expr_stop" correspond α une ou plusieurs expressions liΘes avec les
  97. opΘrateurs spΘciaux && (et) ou || (ou). Les expressions peuvent
  98. consister en:
  99.  
  100. 1) un emplacement
  101.         Un emplacement dans le texte du programme - ceux-ci peuvent se
  102.         comparer α la ponctuation classique.
  103.  
  104. 2) (expr)
  105.         Une expression dans le langage actuel - ce type
  106.         d'expression stop devient vraie en mΩme temps que l'expression
  107.         elle-mΩme ;
  108.  
  109. 3) *lvalue
  110.         Un emplacement dans les donnΘes du programme pouvant Ωtre
  111.         modifiΘ - ce type d'expression se rΘalise lorsque la valeur
  112.         change.
  113.  
  114. Les expressions expr_stop sont ΘvaluΘes en permanence par le dΘbogueur
  115. lorsque le processus sujet ou le chemin d'exΘcution sont exΘcutΘs.
  116. Lorsque l'expression tout entiΦre devient vraie, le dΘbogueur dΘclare
  117. l'occurrence de l'ΘvΘnement et exΘcute la "commande" optionnelle qui y
  118. est associΘe.
  119.  
  120. Pour plus d'informations, reportez-vous α expr_stop.
  121.  
  122. L'option -q indique que le dΘbogueur ne dΘclare pas l'ΘvΘnement.
  123.  
  124. L'option -c indique que l'ΘvΘnement ne se dΘclenche qu'aprΦs un certain
  125. nombre de fois ou l'expression expr_stop devient vraie, nombre indiquΘ par
  126. "nombre". L'ΘvΘnement se dΘclenchera toutes les autres fois ou
  127. l'expression devient vraie.
  128.  
  129. La deuxiΦme forme de la commande stop affiche tous les ΘvΘnements stop
  130. pour la totalitΘ des processus et des chemins d'exΘcution indiquΘs.
  131.  
  132. A la diffΘrence de ce qui se produit pour la plupart des commandes, si
  133. l'option -p n'est pas fournie α la commande stop, celle-ci va
  134. s'appliquer α tous les chemins d'exΘcution ou α tous les processus ne
  135. comportant qu'un chemin d'exΘcution dΘrivΘ du programme actuel
  136. (%program).
  137.  
  138. EXEMPLES
  139. stop myfile.c@230
  140. stop *bar
  141. stop (x == 5)
  142. stop foo && (a > 7)
  143. stop (a == 4) || (b == 7)
  144.  
  145. VOIR EGALEMENT
  146. %program, %verbose, assoccmd, delete, disable, enable, events,
  147. expr, emplacement, liste_proc, scope, expr_stop
  148. ++
  149.  
  150.  
  151. ++ break
  152. NOM
  153. break - sortie d'une boucle while.
  154.  
  155. RESUME
  156. break
  157.  
  158. DESCRIPTION
  159. La commande break force le dΘbogueur α sortir de la boucle while
  160. la plus profonde concernΘe par la commande.
  161.  
  162. EXEMPLES
  163. while($i < 10) { if (x[$i] == $myvar) break; set $i = $i + 1 }
  164.  
  165. VOIR EGALEMENT
  166. continue, while
  167. ++
  168.  
  169.  
  170. ++ continue
  171. NOM
  172. continue - continuation de l'exΘcution de la prochaine itΘration de
  173. la boucle while.
  174.  
  175. RESUME
  176. continue
  177.  
  178. DESCRIPTION
  179. La commande continue force le dΘbogueur α commencer l'exΘcution
  180. de la prochaine itΘration de la boucle while la plus profonde
  181. concernΘe par la commande. L'exΘcution dΘmarre avec la rΘΘvaluation
  182. de l'expression de la boucle.
  183.  
  184. EXEMPLES
  185. while (i < 20) { step; if (i % 2) continue; p i, x[i] }
  186.  
  187. VOIR EGALEMENT
  188. break, while
  189. ++
  190.  
  191.  
  192. ++ cancel
  193. NOM
  194. cancel - annulation des signaux en attente.
  195.  
  196. RESUME
  197. cancel [-p liste_proc] [signal ...]
  198.  
  199. DESCRIPTION
  200. La commande cancel supprime une liste de signaux de l'ensemble
  201. des signaux en attente pour les processus et les chemins d'exΘcution
  202. indiquΘs (%thread ou %proc par dΘfaut). Ces signaux ne sont pas reτus par
  203. les processus ou les chemins d'exΘcution indiquΘs lorsque l'exΘcution
  204. reprend. Si aucun signal n'est spΘcifiΘ, tous les signaux en attente
  205. correspondant aux processus ou aux chemins d'exΘcution indiquΘs seront
  206. annulΘs.
  207.  
  208. EXEMPLES
  209. cancel
  210. cancel segv
  211. cancel -p all sigfpe sigemt
  212.  
  213. VOIR EGALEMENT
  214. kill, liste_proc, signal, signames
  215. ++
  216.  
  217.  
  218. ++ create
  219. NOM
  220. create - crΘation ou contr⌠le d'un ou plusieurs processus nouveaux.
  221.  
  222. RESUME
  223. create [-dr] [-f all|none|procs] [-l start_loc] [cmd_line]
  224.  
  225. DESCRIPTION
  226. La commande create prend une ligne de commande de type shell et crΘe un
  227. ou plusieurs processus. La ligne de commande peut inclure une redirection
  228. d'entrΘe et/ou de sortie, ainsi qu'un canal shell. Tous les processus
  229. rΘsultants s'arrΩtent α l'emplacement spΘcifiΘ par "start_loc".
  230. Si aucun emplacement de dΘmarrage n'est spΘcifiΘ ou que l'emplacement
  231. indiquΘ est introuvable dans l'espace adresse du processus, ce
  232. dernier s'arrΩte α la fonction "main". Si aucune fonction "main" n'existe,
  233. le processus s'arrΩte α l'adresse indiquΘe dans l'en-tΩte du
  234. fichier objet. Pour crΘer et exΘcuter un processus, tapez "create...",
  235. puis "run". 
  236.  
  237. Si aucune "cmd_line" n'est specifiΘe, c'est la "cmd_line"  prΘcΘdente
  238. qui est utilisΘe. Tout processus crΘΘ α partir d'invocations existantes
  239. de cette "cmd_line" est dΘtruit.
  240.  
  241. Chaque processus crΘe un identificateur pour le processus de dΘbogage.
  242. On peut faire rΘfΘrence α un processus par son identificateur ou par son
  243. id systΦme dans les commandes acceptant l'option -p. Le premier
  244. processus crΘΘ dans un pipeline devient le processus actuel (%proc). Si
  245. ce processus fait intervenir des interfaces pour les chemins d'exΘcution,
  246. le chemin d'exΘcution (simple) dans le nouveau processus devient le
  247. chemin d'exΘcution actuel (%thread). On peut faire rΘfΘrence α tous les
  248. processus crΘΘs α partir d'un exΘcutable simple (via fork (2)) par le
  249. nom de cet exΘcutable (nom de programme).
  250.  
  251. Si l'option -r est spΘcifiΘe, les entrΘes/sorties du processus sont
  252. redirigΘes vers un pseudo-terminal. Toutes les sorties sont prΘcΘdΘes
  253. du nom de ce pseudo-terminal. S'il est nΘcessaire de fournir des entrΘes
  254. α ce processus, la commande "input" doit Ωtre utilisΘe. L'option -d
  255. indique qu'il ne doit pas y avoir de redirection. Si aucune des deux
  256. options n'est spΘcifiΘe, le mode spΘcifiΘ par %redir sera utilisΘ
  257. (par dΘfaut, pas de redirection).
  258.  
  259. Si -f est employΘe avec un argument "none" (aucune), le dΘbogueur ne suivra
  260. pas les processus enfants d'un processus utilisant la duplication ("fork").
  261. Si l'option -f est employΘe avec, soit la valeur "all" (tous), soit la
  262. valeur "procs" (processus), tous les processus enfant seront contr⌠lΘs
  263. par le dΘbogueur (ces processus pouvant Ωtre libΘrΘs du contr⌠le
  264. du dΘbogueur en utilisant la commande "release"). Si l'option -f n'est
  265.  pas spΘcifiΘe, le fonctionnement du dΘbogueur sera contr⌠lΘ par %follow
  266. (le fonctionnement par dΘfaut Θtant de suivre tous les processus
  267. enfant).
  268.  
  269. Tous les chemins d'exΘcution crΘΘs par un processus sujet seront suivis par
  270. le dΘbogueur (mais peuvent Ωtre libΘrΘs du contr⌠le du dΘbogueur en
  271. utilisant la commande "release"). Voir la description de %thread_change
  272. pour plus d'informations sur la maniΦre de contr⌠ler le comportement
  273. du dΘbogueur en ce qui concerne les nouveaux chemins d'exΘcution.
  274.  
  275. EXEMPLES
  276. create
  277. create -f none myprog 1 2 3
  278. create myprog 1 2 3 | myfilter1 | myfilter2
  279.  
  280. VOIR EGALEMENT
  281. !, %follow, %program, %redir, grab, input, liste_proc, processus,
  282. program, rename, release, %thread, %thread_change
  283. ++
  284.  
  285.  
  286. ++ delete
  287. NOM
  288. delete - suppression des ΘvΘnements.
  289.  
  290. RESUME
  291. delete numΘro d'ΘvΘnement ...
  292. delete -a [-p liste_proc] [type_ΘvΘnement]
  293.  
  294. DESCRIPTION
  295. La premiΦre syntaxe supprime les ΘvΘnements correspondant
  296. aux numΘros d'ΘvΘnements spΘcifiΘs.
  297.  
  298. La deuxiΦme syntaxe supprime tous les ΘvΘnements, correspondant α
  299. l' "event_type" spΘcifiΘ (si aucun type n'est spΘcifiΘ, la commande
  300. supprime tous les types d'ΘvΘnements), dans la liste indiquΘe des
  301. chemins d'exΘcution et des processus (ou dans le chemin d'exΘcution ou le
  302. processus actuel, si aucune liste n'est spΘcifiΘe).
  303. Le "type d'ΘvΘnement" peut Ωtre l'un des suivants: "onstop", "signal", "stop" ou
  304. "syscall".
  305.  
  306.  
  307. EXEMPLES
  308. delete 1 3 5
  309. delete -a -p p1
  310. delete -a stop
  311. delete -a syscall
  312.  
  313. VOIR EGALEMENT
  314. change, disable, enable, events, onstop, liste_proc,
  315. signal, stop, syscall
  316. ++
  317.  
  318.  
  319. ++ dis
  320. NOM
  321. dis - dΘsassemblage des instructions machine.
  322.  
  323. RESUME
  324. dis [-p liste_proc] [-c nombre_instr] [emplacement]
  325.  
  326. DESCRIPTION
  327. DΘsassemble un nombre d'instructions correspondant α
  328. "instr_count" dans chaque chemin d'exΘcution ou processus spΘcifiΘ (la valeur
  329. par dΘfaut Θtant %thread ou %proc). Si une valeur n'est pas donnΘe
  330. pour "instr_count", la valeur par dΘfaut est Θgale α %num_lines, cette
  331. valeur commenτant α 10 et pouvant Ωtre changΘe.
  332.  
  333. Si un "emplacement" est donnΘ, le dΘsassemblage commenτe α l'emplacement
  334. spΘcifiΘ par "emplacement" dans chaque chemin d'exΘcution ou processus.
  335. Si aucun emplacement n'est donnΘ, la premiΦre commande "dis" aprΦs le
  336. lancement d'un ΘvΘnement ou aprΦs la remise α zΘro de %frame, commenτera
  337. α %loc. Les commandes "dis" suivantes continueront α partir de
  338. l'adresse se trouvant juste aprΦs la derniΦre instruction affichΘe par
  339. la commande "dis" prΘcΘdente.
  340.  
  341. EXEMPLES
  342. dis
  343. dis -c 20 main
  344. dis file.c@10
  345.  
  346. VOIR EGALEMENT
  347. %frame, %loc, %num_lines, dump, emplacement, print, liste_proc
  348. ++
  349.  
  350.  
  351. ++ disable
  352. NOM
  353. disable - dΘsactivation des ΘvΘnements
  354.  
  355. RESUME
  356. disable event_num ...
  357. disable -a [-p liste_proc] [type_ΘvΘnement]
  358.  
  359. DESCRIPTION
  360. La premiΦre syntaxe dΘsactive les ΘvΘnements correspondants aux
  361. numΘros spΘcifiΘs.
  362.  
  363. La deuxiΦme syntaxe dΘsactive tous les ΘvΘnements de l' "event_type"
  364. spΘcifiΘ (ou tous les types d'ΘvΘnements, si un type n'a
  365. pas ΘtΘ spΘcifiΘ) dans la liste des chemins d'exΘcution et des
  366. processus (ou le chemin d'exΘcution/processus actuel, si aucun n'a
  367. ΘtΘ spΘcifiΘ). L' "event_type" peut Ωtre l'un des suivants: "onstop",
  368. "signal", "stop" ou "syscall".
  369.  
  370. Les ΘvΘnements dΘsactivΘs n'ont aucun effet sur les chemins d'exΘcution
  371. et les processus sur lesquels ils s'appliquent, mais ils ne sont pas
  372. effacΘs. Ils peuvent Ωtre rΘ-installΘs en utilisant la commande "enable".
  373.  
  374. EXEMPLES
  375. disable 3 5
  376. disable -a -p p1.1,p2.3
  377. disable -a onstop
  378. disable -a signal
  379.  
  380. VOIR EGALEMENT
  381. change, delete, enable, events, onstop, liste_proc, signal,
  382. stop, syscall
  383. ++
  384.  
  385. ++ dump
  386. NOM
  387. dump - affiche le contenu de la mΘmoire
  388.  
  389. RESUME
  390. dump [-p liste_proc] [-c nombre_octet] emplacement
  391.  
  392. DESCRIPTION
  393. La commande dump affiche le contenu de la mΘmoire pour chaque chemin
  394. d'exΘcution (ou chaque processus) spΘcifiΘ (la valeur par dΘfaut Θtant
  395. %thread ou %proc). Cette commande affiche "nombre_octet" octets, α raison
  396. de 16 octets par ligne, en hexadΘcimal ou en ASCII, en commenτant α
  397. l'adresse donnΘe par "emplacement".
  398.  
  399. Si aucun "nombre_octet" n'est spΘcifiΘ, la commande affiche %num_bytes
  400. octets, cette valeur par dΘfaut commenτant α 256 et pouvant Ωtre changΘe.
  401.  
  402. EXEMPLES
  403. dump -c 16 myptr
  404. dump %esp
  405. dump 0x80001248
  406.  
  407. VOIR EGALEMENT
  408. %num_bytes, dis, emplacement, print, liste_proc
  409. ++
  410.  
  411.  
  412. ++ enable
  413. NOM
  414. enable - activation des ΘvΘnements
  415.  
  416. RESUME
  417. enable event_num ...
  418. enable -a [-p liste_proc] [type_ΘvΘnement]
  419.  
  420. DESCRIPTION
  421. La premiΦre syntaxe active les ΘvΘnements correspondants aux numΘros
  422. d'ΘvΘnements spΘcifiΘs.
  423.  
  424. La deuxiΦme syntaxe active tous les ΘvΘnements correspondant au type
  425. d'ΘvΘnement spΘcifiΘ (ou tous les types, si un type particulier n'est
  426. pas spΘcifiΘ) dans la liste des chemins d'exΘcution et des
  427. processus (ou le chemin d'exΘcution/le processus actuel, si un chemin
  428. d'exΘcution ou un processus n'est pas spΘcifiΘ). Le "type_ΘvΘnement" peut
  429. Ωtre l'un des suivants: "onstop", "signal", "stop" ou "syscall".
  430.  
  431. Seuls les ΘvΘnements prΘalablement dΘsactivΘs peuvent Ωtre activΘs. Une
  432. fois activΘ, un ΘvΘnement affectera de nouveau le chemin d'exΘcution ou
  433. le processus dans lequel il est dΘfini.
  434.  
  435. EXEMPLES
  436. enable 3 5
  437. enable -a -p p1,p2.3
  438. enable -a stop
  439. enable -a signal
  440.  
  441. VOIR EGALEMENT
  442. change, delete, disable, events, onstop, liste_proc, signal,
  443. stop, syscall
  444. ++
  445.  
  446.  
  447. ++ events
  448. NOM
  449.  events - liste des ΘvΘnements
  450.  
  451. RESUME
  452. events [-p liste_proc] [nombre_ΘvΘnement ...]
  453.  
  454. DESCRIPTION
  455. Si aucun argument n'est spΘcifiΘ, la commande "events" affiche une
  456. liste de tous les ΘvΘnements stop, de  toutes les signaux,  de tous les
  457. appels au systΦme et de tous les ΘvΘnements "onstop" pour le chemin
  458. d'exΘcution ou le processus, actuel. Avec l'option -p, cette commande
  459. affiche une liste de tous les ΘvΘnements associΘs aux chemins
  460. d'exΘcution et aux processus spΘcifiΘs.
  461.  
  462. Si un (ou plusieurs) numΘro d'ΘvΘnement est spΘcifiΘ, la commande
  463. "events" affiche une liste complΦte des ΘvΘnements spΘcifiΘs. Cette
  464. liste complΦte comprend tous les chemins d'exΘcution et tous les
  465. processus pour lesquels un ΘvΘnement est spΘcifiΘ et le bloc de
  466. commande associΘ, le cas ΘchΘant.
  467.  
  468. EXEMPLES
  469. events
  470. events -p p1,p2.3
  471. events 3
  472.  
  473. VOIR EGALEMENT
  474. change, delete, disable, enable, onstop, liste_proc, signal,
  475. stop, syscall
  476. ++
  477.  
  478.  
  479. ++ grab
  480. NOM
  481. grab - prend le contr⌠le des processus en cours ou d'une image du noyau.
  482.  
  483. RESUME
  484. grab  [-f all|none|procs] [-l load_file] process_specifier ...
  485. grab -c corefile objectfile
  486.  
  487. DESCRIPTION
  488. La premiΦre syntaxe accepte un ou plusieurs
  489. "process_specifiers" ; debug essayera alors de prendre le contr⌠le
  490. de chaque processus spΘcifiΘ (le contr⌠le n'Θtant accordΘ que si vous
  491. avez les autorisations nΘcessaires). Chaque processus peut Ωtre spΘcifiΘ
  492. soit comme un chemin d'accΦs /proc, soit comme un id de processus.
  493.  
  494. L'option -l indique qu'un fichier objet de remplacement α utiliser pour
  495. charger les symboles du processus. Si l'option -l est spΘcifiΘe, vous
  496. ne pouvez indiquer qu'un seul processus.
  497.  
  498. Si -f est employΘe avec un argument "none" (aucune), le dΘbogueur ne suivra
  499. pas les processus enfants d'un processus utilisant la duplication ("fork").
  500. Si l'option -f est employΘe avec, soit la valeur "all" (tous), soit la
  501. valeur "procs" (processus), tous les processus enfant seront contr⌠lΘs
  502. par le dΘbogueur (ces processus pouvant Ωtre libΘrΘs du contr⌠le
  503. du dΘbogueur en utilisant la commande "release"). Si l'option -f n'est
  504.  pas spΘcifiΘe, le fonctionnement du dΘbogueur sera contr⌠lΘ par %follow
  505. (le fonctionnement par dΘfaut Θtant de suivre tous les processus
  506. enfant).
  507.  
  508. Tous les chemins d'exΘcution crΘΘs par un processus sujet seront suivis par
  509. le dΘbogueur (mais peuvent Ωtre libΘrΘs du contr⌠le du dΘbogueur en
  510. utilisant la commande "release"). Voir la description de %thread_change
  511. pour plus d'informations sur la maniΦre de contr⌠ler le comportement
  512. du dΘbogueur en ce qui concerne les nouveaux chemins d'exΘcution.
  513.  
  514. La deuxiΦme syntaxe ouvre et examine un fichier source et son fichier
  515. objet correspondant. Les images noyau crΘΘes par grab peuvent Ωtre
  516. examinΘes en utilisant toutes les commandes disponibles pour
  517. l'examen des processus en cours d'exΘcution, mais sans que l'on puisse
  518. les modifier ou les lancer.
  519.  
  520. Les processus examinΘs avec grab, comme les processus crΘΘs normalement,
  521. reτoivent un identificateur de processus du dΘbogueur et peuvent
  522. Ωtre rΘfΘrencΘs soit avec cet identificateur, soit par l'id de leur
  523. processus systΦme, soit encore par le nom du programme dont ils
  524. proviennent. Le premier processus examinΘ par grab devient le
  525. processus actuel (%proc). Si ce processus utilise l'interface des
  526. chemins d'exΘcution, le dΘbogueur choisit un chemin d'exΘcution de ce
  527. processus qui devient le chemin d'exΘcution actuel (%thread).
  528.  
  529. EXEMPLES
  530. grab 123
  531. grab -f procs /proc/123 3455
  532. grab -l myobject /proc/3455
  533. grab -c core.save myobject
  534.  
  535. VOIR EGALEMENT
  536. %follow, %proc, %program, create, liste_proc, processus, release,
  537. rename, %thread, %thread_change
  538. ++
  539.  
  540.  
  541. ++ help
  542. NOM
  543. help - demande de l'aide
  544.  
  545. RESUME
  546. help [sujet]
  547.  
  548. DESCRIPTION
  549. Le "sujet" peut Ωtre un alias, un nom de commande ou un sujet
  550. d'aide quelconque. Si aucun sujet n'est spΘcifiΘ, la liste des
  551. commandes disponibles et des sujets s'affiche.
  552.  
  553. EXEMPLES
  554. help
  555. help stop
  556. help b
  557. help emplacement
  558. ++
  559.  
  560.  
  561. ++ if
  562. NOM
  563. if - branchement conditionnel.
  564.  
  565. RESUME
  566. if (expr) cmd
  567. if (expr) cmd else cmd
  568.  
  569. DESCRIPTION
  570. L'expression "expr" est ΘvaluΘe dans le langage courant (%db_lang
  571. ou %lang) dans le contexte du chemin d'exΘcution ou d'un processus
  572. ne comportant qu'un seul chemin d'exΘcution. Si l'expression ΘvaluΘe
  573. est vraie, la partie "then" est exΘcutΘe. Dans le cas contraire,
  574. c'est la partie "else" qui est exΘcutΘe, le cas ΘchΘant ;
  575. "cmd" pouvant Ωtre une simple commande ou un bloc de commande.
  576.  
  577. EXEMPLES
  578. stop  file.c@myfunc { if (x < 10) run; else print x }
  579.  
  580. VOIR EGALEMENT
  581. %db_lang, %lang, bloc, expr, scope, while
  582. ++
  583.  
  584.  
  585. ++ input
  586. NOM
  587. input - envoi d'une entrΘe α un processus.
  588.  
  589. RESUME
  590. input [-p nom_proc|-r pseudo-tty] [-n] chaεne
  591.  
  592. DESCRIPTION
  593. Si un processus a ΘtΘ crΘΘ en utilisant la commande "create -r", ses
  594. entrΘes et ses sorties, ainsi que les entrΘes/sorties des autres
  595. processus dΘrivΘs du mΩme programme, sont redirigΘes vers un
  596. pseudo-terminal. Pour envoyer une entrΘe α un tel processus, la
  597. commande "input" doit Ωtre utilisΘe.
  598.  
  599. "pseudo-tty" est le nom du pseudo-terminal sur lequel les entrΘes
  600. doivent Ωtre dirigΘes. Le dΘbogueur affiche le nom du
  601. pseudo-terminal α cotΘ des sorties redirigΘes du processus. Il est
  602. Θgalement possible d'afficher le nom du processus ou celui du
  603. programme. Si aucun processus ou nom de pseudo-terminal n'est
  604. spΘcifiΘ, le pseudo-terminal associΘ au programme actuel est celui qui
  605. sera utilisΘ.
  606.  
  607. L'entrΘe "chaεne" est envoyΘe au pseudo-terminal indiquΘ ou au
  608. pseudo-terminal associΘ au processus (ou au programme) spΘcifiΘ. Une
  609. nouvelle ligne est ajoutΘe α la fin de la chaεne, α moins que
  610. l'option -n ne soit spΘcifiΘe.
  611.  
  612. EXEMPLES
  613. input -r pts1 "voici une chaεne de caractΦres"
  614. input -p myprog "en voici une autre"
  615.  
  616. VOIR EGALEMENT
  617. %redir, create
  618. ++
  619.  
  620.  
  621. ++ jump
  622. NOM
  623. jump - change le compteur du chemin d'exΘcution ou du processus.
  624.  
  625. RESUME
  626. jump [-p liste_proc] emplacement
  627.  
  628. DESCRIPTION
  629. Un chemin d'exΘcution ou un processus doit Ωtre arrΩtΘ avant que cette
  630. commande ne puisse lui Ωtre appliquΘe avec succΦs. La commande jump
  631. dΘplace le compteur d'une liste de chemin d'exΘcution ou de
  632. processus (%thread ou %proc par dΘfaut) jusqu'α l'adresse indiquΘe par
  633. "emplacement". Lorsque le chemin d'exΘcution ou le
  634. processus reprend son exΘcution, il commenτera α partir de cette
  635. adresse.
  636.  
  637. L'emplacement peut Ωtre une adresse quelconque dans le
  638. texte du chemin d'exΘcution ou du processus, mais une attention
  639. extrΩme doit Ωtre prise. En effet, la commande jump n'essaye pas
  640. d'ajuster la pile du processus ou du chemin d'exΘcution si l'adresse est
  641. situΘe en-dehors de la fonction actuelle. Des prΘcautions doivent donc
  642. Ωtre prises lorsque l'on effectue des sauts dans un programme
  643. pouvant avoir des effets secondaires importants.
  644.  
  645. RESUME
  646. jump 10
  647. jump -p p2.1 main+8
  648.  
  649. VOIR EGALEMENT
  650. emplacement, liste_proc
  651.  ++
  652.  
  653.  
  654. ++ kill
  655. NOM
  656. kill - envoi d'un signal vers un chemin d'exΘcution ou un processus.
  657.  
  658. RESUME
  659. kill [-p liste_proc] [signal]
  660.  
  661. DESCRIPTION
  662. Le "signal" spΘcifiΘ est envoyΘ vers le chemin d'exΘcution, vers le
  663. processus ne comprenant qu'un seul chemin d'exΘcution, en
  664. direction de la liste des chemins d'exΘcution ou vers les processus qui
  665. ont reτus l'option -p. A la diffΘrence de ce qui se produit avec les autres
  666. commandes du dΘbogueur, si un identificateur de processus est donnΘ
  667. dans "liste_proc", le signal est envoyΘ au processus dans son
  668. ensemble, au lieu d'Ωtre envoyΘ α chaque chemin d'exΘcution α
  669. l'intΘrieur du processus.
  670.  
  671. Les signaux peuvent Ωtre spΘcifiΘs par leur numΘro ou par leur nom. Un
  672. nom de signal peut Ωtre spΘcifiΘ avec ou sans le prefixe "SIG". Les
  673. majuscules ou les minuscules n'Θtant pas prises en compte. Si un
  674. signal n'est pas spΘcifiΘ, la commande "kill" utilise le signal
  675. "SIGKILL".
  676.  
  677. EXEMPLES
  678. kill -p p1.2,p2.3
  679. kill sigfpe
  680. kill -p p3 8
  681.  
  682. VOIR EGALEMENT
  683. cancel, liste_proc, signal, signames
  684. ++
  685.  
  686.  
  687. ++ list
  688. NOM
  689. list - affiche les lignes de code source.
  690.  
  691. RESUME
  692. list [-p liste_proc] [-c nombre] [thread id@][nom_fichier@]nom_func
  693. list [-p liste_proc] [-c nombre] [thread id@][nom_fichier@]num_ligne 
  694. list [-p liste_proc] [-c nombre] /expr_rΘg/ 
  695. list [-p liste_proc] [-c nombre] ?expr_rΘg? 
  696. list [-p liste_proc] [-c nombre]
  697.  
  698. DESCRIPTION
  699. La commande list affiche les lignes du code source pour les chemins
  700. d'exΘcution et pour les processus spΘcifiΘs ou pour le chemin
  701. d'exΘcution (ou le processus) actuel si une "liste_proc" (liste des
  702. procΘdures) n'a pas ΘtΘ spΘcifiΘe.
  703.  
  704. Les quatres premiΦres syntaxes indiquent des points de dΘpart
  705. pour l'affichage. Les deux premiΦres permettent d'indiquer un
  706. chemin d'exΘcution ou un processus, un numΘro de fichier, de
  707. fonction ou un numΘro de ligne. Le "thread id" (identificateur de
  708. chemin d'exΘcution) peut faire rΘfΘrence α un chemin d'exΘcution
  709. ou α un processus ne comportant qu'un seul chemin d'exΘcution. Si
  710. un chemin d'exΘcution ou un processus est spΘcifiΘ, il remplace
  711. la liste des processus qui a pu Ωtre donnΘe en utilisant l'option
  712. -p.
  713.  
  714. La troisiΦme syntaxe trouve la ligne correspondant α l'expression
  715. de recherche de type ed(1). La quatriΦme syntaxe recherche vers
  716. le haut, en partant de la ligne actuelle. La barre oblique de fin
  717. ou le point d'interrogation peut Ωtre omis, α moins qu'une autre
  718. commande ne suive sur la meme ligne. La derniΦre syntaxe continue
  719. l'affichage α partir du fichier et de la ligne ou la commande
  720. list prΘcΘdente s'est arrΩtΘe ou encore α partir de %file@%line
  721. aprΦs le dΘclenchement d'un ΘvΘnement ou d'une remise α zΘro de
  722. %frame.
  723.  
  724. Si une limite ("nombre") a ΘtΘ spΘcifiΘe, le nombre de lignes
  725. correspondant sera affichΘ, sinon seules %num_lines lignes seront
  726. affichΘes, cette valeur partant de 10 et pouvant Ωtre changΘ.
  727.  
  728. AprΦs l'affichage d'un bloc de lignes, %list_file devient le nom
  729. du fichier affichΘ et %list_lines le numΘro de la derniΦre ligne
  730. de code source qui a ΘtΘ affichΘe.
  731.  
  732. EXEMPLES
  733. list -c 20
  734. list myfile@1
  735. list myfunc
  736. list /x/
  737. list ?foobar
  738. list /
  739.  
  740. VOIR EGALEMENT
  741. %file, %frame, %line, %list_file, %list_line, emplacement,
  742. print, liste_proc, expr_rΘg
  743. ++
  744.  
  745. ++ map
  746. NOM
  747. map - affiche l'allocation des adresses virtuelles.
  748.  
  749. RESUME
  750. map [-p liste_proc]
  751.  
  752. DESCRIPTION
  753. Affiche l'assignation des adresses virtuelles pour un (ou plusieurs)
  754. chemin d'exΘcution ou processus. Sans argument, cette commande
  755. affiche l'assignation du processus actuel (%proc). Notez que, puisque
  756. tous les chemins d'exΘcution α l'intΘrieur d'un processus partagent
  757. un espace d'adresses commun, l'assignation des adresses virtuelles
  758. sera identique pour tous les chemins d'exΘcution α l'intΘrieur
  759. d'un mΩme processus.
  760.  
  761. VOIR EGALEMENT
  762. create, grab, liste_proc
  763. ++
  764.  
  765.  
  766. ++ symbols
  767. NOM
  768. symbols - affiche les noms, les valeurs et les types des symboles.
  769.  
  770. RESUME
  771. symbols [-p liste_proc] [-o objet] [-n nom_fichier] [-dfgltuv] [argument]
  772.  
  773. DESCRIPTION
  774. Affiche une liste des noms de variables visibles α partir de la trame
  775. actuelle (%frame) dans le chemin d'exΘcution ou dans le processus
  776. spΘcifiΘ (par dΘfaut %thread ou %proc). Sans options, (ou avec l'option
  777. -l), affiche les noms locaux dΘfinis dans la fonction actuelle (%func).
  778. L'option -f n'affiche que les noms des variables qui sont locales
  779. dans le fichier actuel (%file). Si un "nom_fichier" (nom de fichier)
  780. est spΘcifiΘ avec l'option -n, les symboles du fichier sont affichΘs.
  781. Si l'option -g est utilisΘe avec l'option -o, elle affiche les noms
  782. globaux dΘfinis dans l'objet spΘcifiΘ. L'option -d affiche les
  783. variables internes du dΘbogueur. L'option -u affiche les variables
  784. utilisateurs gΘrΘes par le dΘbogueur.
  785.  
  786. Si un argument de type sh(1) est utilisΘ, celui-ci restreint encore plus
  787. l'affichage pour n'y inclure que les noms de variables
  788. correspondants α l'argument de recherche.
  789.  
  790. L'option -t affiche les types des symboles en mΩme temps que les noms.
  791. L'option -v affiche la valeur des symboles. Notez que lorsque le langage
  792. actuel est le C++, la commande "symbols -v" n'affiche pas les membres
  793. des classes statiques. Ceux-ci peuvent Ωtre affichΘs en imprimant
  794. le symbole avec la commande "print".
  795.  
  796. EXEMPLES
  797. symbols -ftv
  798. symbols -g -o libc.so.1 exec*
  799.  
  800. VOIR EGALEMENT
  801. %file, %frame, %func, modΦle, print, liste_proc
  802. ++
  803.  
  804.  
  805. ++ print
  806. NOM
  807. print - imprime la valeur d'une expression.
  808.  
  809. RESUME
  810. print [-p liste_proc] [-f format] [-v] expr, ...
  811.  
  812. DESCRIPTION
  813. Affiche les rΘsultats de l'Θvaluation d'une liste
  814. d'expressions sΘparΘes par des virgules. Les expressions sont ΘvaluΘes
  815. dans le contexte des chemins d'exΘcution et des processus spΘcifiΘs
  816. (par dΘfaut %thread et %proc). L'option -f a besoin d'un format
  817. (which see). Les expressions peuvent contenir des variables de programmes,
  818. des variables internes au dΘbogueur (%line, par exemple) et des
  819. variables dΘfinies par l'utilisateur ($myvar, $HOME). L'Θvaluation d'un
  820. appel de fonction a pour rΘsultat la crΘation, par le dΘbogueur, d'une
  821. trame de pile pour la fonction, ainsi que son exΘcution. Les
  822. ΘvΘnements du dΘbogueur sont interdits pendant l'exΘcution de la
  823. fonction. Les expressions sont ΘvaluΘes dans le langage actuel (%lang
  824. ou %db_lang). Un espace est imprimΘ aprΦs chaque expression et une
  825. nouvelle ligne est ajoutΘe α la fin, α moins qu'un format ne soit spΘcifiΘ.
  826.  
  827. L'option -v affiche des informations plus dΘtaillΘes. Les informations
  828. supplΘmentaires comprennent des prototypes de fonctions  pour toutes
  829. les fonctions, appelΘs par le dΘbogueur lors de l'Θvaluation de l'expression.
  830. Ceci est utile en C++ afin de voir comment les fonctions
  831. surchargΘes sont rΘsolues. L'option -v affichera Θgalement la structure
  832. gΘnΘrΘe par le compilateur et les membres des classes, comme les
  833. pointeurs en direction des tables de fonctions virtuelles.
  834.  
  835. La commande "set" peut Θgalement Ωtre utilisΘe afin d'Θvaluer des
  836. expressions du langage. Par contre, elle n'imprime pas le rΘsultat d'une
  837. expression. Elle est utilisΘe principalement pour Θvaluer une
  838. expression pouvant avoir des effets secondaires, comme une
  839. assignation.
  840.  
  841. EXEMPLES
  842. print %line, %file, %func
  843. print "a[i] == ", a[i]
  844. print *ptr->next
  845. print -f "0x%x\n" main
  846. print -v myfunc(1, 2, 3)
  847.  
  848. VOIR EGALEMENT
  849. %db_lang, %lang, C++, expr, format, liste_proc, scope, set
  850. ++
  851.  
  852. ++ ps
  853. NOM
  854. ps - Θtat du processus.
  855.  
  856. RESUME
  857. ps [-p liste_proc]
  858.  
  859. DESCRIPTION
  860. Affiche l'Θtat des processus et des chemins d'exΘcution contr⌠lΘs.
  861. Si l'option -p n'est pas spΘcifiΘe, affiche alors l'Θtat de tous les
  862. processus et chemins d'exΘcution contr⌠lΘs. Le chemin d'exΘcution
  863. actuel (%thread), s'il y en a un ou le processus actuel (%proc) est
  864. affichΘ avec un astΘrisque (*).
  865.  
  866. VOIR EGALEMENT
  867. liste_proc
  868. ++
  869.  
  870. ++ pwd
  871. NOM
  872. pwd - affiche le rΘpertoire de travail actuel.
  873.  
  874. RESUME
  875. pwd
  876.  
  877. DESCRIPTION
  878. pwd affiche le rΘpertoire de travail actuel du dΘbogueur.
  879.  
  880. VOIR EGALEMENT
  881. cd
  882. ++
  883.  
  884. ++ quit
  885. NOM
  886. quit - sort du dΘbogueur.
  887.  
  888. RESUME
  889. quit
  890.  
  891. DESCRIPTION
  892. Sort du dΘbogueur. 
  893. Tous les processus contr⌠lΘs seront arrΩtΘs (s'ils ont ΘtΘ crΘΘs) ou 
  894. libΘrΘs et lancΘs (s'ils Θtaient contr⌠lΘs par la commande grab).
  895.  
  896. VOIR EGALEMENT
  897. release
  898. ++
  899.  
  900. ++ release
  901. NOM
  902. release - libΦre un ou plusieurs des chemins d'exΘcution ou des
  903. processus contr⌠lΘs.
  904.  
  905. RESUME
  906. release [-s] [-p liste_proc]
  907.  
  908. DESCRIPTION
  909. Les chemins d'exΘcution (ou les processus) nommΘs (%thread ou %proc par
  910. dΘfaut) ne sont plus contr⌠lΘs ou vΘrifiΘs par le dΘbogueur.
  911. Par dΘfaut, chaque chemin d'exΘcution (ou chaque processus) est libΘrΘ
  912. et peut poursuivre son exΘcution. Avec l'option -s, chaque processus
  913. est libΘrΘ dans un Θtat d'arrΩt. Cette option est ignorΘe en ce qui
  914. concerne les chemins d'exΘcution. Un chemin d'exΘcution (ou un
  915. processus) peut Ωtre libΘrΘ meme s'il n'a pas fait l'objet d'une
  916. commande "grab" de la part du dΘbogueur, c'est-α-dire que des
  917. processus crΘΘs peuvent Θgalement Ωtre libΘrΘs.
  918.  
  919. EXEMPLES
  920. release -p p1
  921. release -s
  922.  
  923. VOIR EGALEMENT
  924. liste_proc, quit
  925. ++
  926.  
  927. ++ run
  928. NOM
  929. run - lance l'exΘcution d'un chemin d'exΘcution ou d'un processus.
  930.  
  931. RESUME
  932. run [-p liste_proc] [-bfr] [-u emplacement]
  933.  
  934. DESCRIPTION
  935. Lance l'exΘcution d'une liste spΘcifiΘe de chemin d'exΘcution
  936. et de processus (%thread ou %proc par dΘfaut). L'option -f indique que
  937. le dΘbogueur doit lancer cette exΘcution en avant-plan, c'est-α-dire
  938. d'attendre, pour rendre le contr⌠le α l'utilisateur, la fin de
  939. l'exΘcution des processus et des chemins d'exΘcution. L'option -b
  940. indique une exΘcution en arriΦre-plan (sans attente). L'utilisateur peut
  941. alors reprendre le contr⌠le immΘdiatement et le chemin d'exΘcution ou le
  942. processus est lancΘ. Si aucune des deux options ci-dessus n'est
  943. utilisΘe, la valeur par dΘfaut est dΘterminΘe en fonction de la
  944. variable interne %wait du dΘbogueur.
  945.  
  946. L'option -r entraεne l'exΘcution du processus ou du chemin d'exΘcution
  947. jusqu'au retour α la fonction actuelle. L'option -u indique un
  948. "emplacement" pour le lancement.
  949.  
  950. Notez que les chemins d'exΘcution qui ne sont pas exΘcutΘs sur un noyau
  951. de taille rΘduite ne peuvent pas Ωtre lancΘs (de tels chemins
  952. d'exΘcution s'affiche avec l'Θtat "Off LWP" lors de la commande "ps").
  953.  
  954. EXEMPLES
  955. run -p all -b
  956. run -r
  957. run -u 108
  958.  
  959. VOIR EGALEMENT
  960. %wait, emplacement, liste_proc ps, step, thread
  961. ++
  962.  
  963. ++ script
  964. NOM
  965. script - exΘcute une commande script du dΘbogueur.
  966.  
  967. RESUME
  968. script [-q] fname
  969.  
  970. DESCRIPTION
  971. Lit et exΘcute des commandes du dΘbogueur α partir d'un fichier.
  972. Les commandes sont affichΘes avant leur exΘcution, α moins que l'option
  973. -q ne soit spΘcifiΘe. Les scripts pouvant Ωtre imbriquΘs.
  974. ++
  975.  
  976. ++ set
  977. NOM
  978. set - modifie la valeur d'une variable du dΘbogueur ou d'un programme.
  979.  
  980. RESUME
  981. set [-p liste_proc] [-v] variable_dΘbog_ou_utilisateur [=] expr [,expr...]
  982. set [-p liste_proc] [-v] expression_langue
  983.  
  984. DESCRIPTION
  985. La commande "set" possΦde deux syntaxes. La premiΦre est utilisΘe
  986. afin d'allouer une nouvelle valeur α une variable interne du dΘbogueur
  987. ou une variable dΘfinie par l'utilisateur et gΘrΘe par le dΘbogueur
  988. (par exemple, %lang ou $foo). Les valeurs correctes pour
  989. l'expression "expr" dΘpendent de la variable. Certaines variables, comme
  990. %lang, accepte une sΘrie de nom spΘcialement dΘfinis. D'autres
  991. variables peuvent accepter toutes les expressions du dΘbogueur ou d'un
  992. langage qui peuvent Ωtre converties en chaεne de caractΦres. Dans le
  993. cas d'une liste de chaεnes de caractΦres (et de variables
  994. utilisateurs) sΘparΘes par des virgules, les valeurs des chaεnes
  995. de caractΦres de ces expressions sont concatΘnΘes. Voir la commande
  996. "help" de chaque variable du dΘbogueur pour afficher les valeurs
  997. correctes dans chaque cas.
  998.  
  999. Avec la deuxiΦme syntaxe, la commande "set" peut Ωtre utilisΘe pour
  1000. Θvaluer une expression dans un langage quelconque, bien que son
  1001. utilisation soit surtout l'Θvaluation d'une allocation. Si plus d'un
  1002. processus ou plus d'un chemin d'exΘcution, est spΘcifiΘ, la commande
  1003. est ΘvaluΘe dans le contexte de chaque chemin d'exΘcution ou de chaque
  1004. processus, dans l'ordre spΘcifiΘ.
  1005.  
  1006. L'option -v affiche les prototypes des fonctions, pour toutes les
  1007. fonctions appelΘes par le dΘbogueur lors de l'Θvaluation de
  1008. l'expression. Ceci est utile en C++ afin de voir comment les fonction
  1009. surchargΘes sont rΘsolues.
  1010.  
  1011. EXEMPLES
  1012. set %global_path = %global_path, ":src/new/mydir"
  1013. set -p all %path = "mydir"
  1014. set %frame 2
  1015. set %eax = 0x3421
  1016. set x = 3
  1017. set -v myfunc(a, b)
  1018.  
  1019. VOIR EGALEMENT
  1020. %db_lang, %lang, C++, expr, liste_proc, scope, uservars
  1021. ++
  1022.  
  1023.  
  1024. ++ signal
  1025. NOM
  1026. signal - modifie ou affiche la liste des actions pour un chemin
  1027. d'exΘcution ou un processus.
  1028.  
  1029. RESUME
  1030. signal [-p liste_proc] [-iq] [signal ... [commande]]
  1031.  
  1032. DESCRIPTION
  1033. Lorsqu'un signal est envoyΘ α un chemin d'exΘcution ou α un processus,
  1034. le dΘbogueur, par dΘfaut, intercepte le signal et annonce son arrivΘe.
  1035. Le signal peut ensuite Ωtre annulΘ en utilisant la commande "cancel"
  1036. ou le processsus peut continuer son exΘcution et reτevoir le signal.
  1037. L'option -i, combinΘe α un (ou plusieurs) nom de signal ou numΘro
  1038. de signal (voir la commande "kill") indique que le dΘbogueur doit ignorer
  1039. ce signal (c'est-α-dire ne pas l'intercepter pour la liste des processus
  1040. et des chemins d'exΘcution fournie par liste_proc). Un nom de signal
  1041. peut Ωtre donnΘ avec ou sans le prΘfixe "SIG". Les majuscules et les
  1042. minuscules n'Θtant pas prise en compte. SpΘcifier de nouveau le signal
  1043. avec l'option -i rΘtablit l'action par dΘfaut pour ce signal.
  1044.  
  1045. Si une commande est donnΘe avec un groupe de signaux, le dΘbogueur
  1046. Θtablit un ΘvΘnement pour ce groupe. L'ΘvΘnement peut Ωtre effacΘ,
  1047. dΘsactivΘ ou activΘ, tout comme les ΘvΘnements "stop", "onstop" et
  1048. "syscall". Des ΘvΘnements multiples peuvent Ωtre allouΘs au mΩme
  1049. signal. Effacer tous lesΘvΘnements pour un signal donnΘ n'enlΦve pas
  1050. l'action par dΘfaut du dΘbogueur pour ce signal. L'option -q indique que
  1051.  le signal ne sera pas annoncΘ.
  1052.  
  1053. Sans arguments, cette commande affiche la liste des signaux
  1054. correspondant α la liste des processus fournie par liste_proc.
  1055.  
  1056. A la diffΘrence de ce qui se passe pour d'autres commandes, si l'option
  1057. -p n'est pas spΘcifiΘe lors de la commande "signal", son action s'applique
  1058. α tous les chemins d'exΘcutions et α tous les processus dΘrivΘs du
  1059. programme actuel (%program).
  1060.  
  1061. EXEMPLES
  1062. signal -i fpe emt
  1063. signal SIGFPE
  1064. signal 8 { if (x == 0) cancel 8; run }
  1065.  
  1066. VOIR EGALEMENT
  1067. assoccmd, cancel, delete, disable, enable, kill, liste_proc, signames
  1068. ++
  1069.  
  1070. ++ step
  1071. NOM
  1072. step - lance un processus pas α pas.
  1073.  
  1074. RESUME
  1075. step [-p liste_proc] [-ibfoq] [-c nombre]
  1076.  
  1077. DESCRIPTION
  1078. La liste des chemins d'exΘcution et des processus (par dΘfaut
  1079. %thread ou %proc) sera lancΘe pas α pas, α hauteur de la valeur d
  1080. l'argument "nombre" (par dΘfaut une fois). Un "nombre" de 0 indique un
  1081. lancement rΘpΘtitif, jusqu'α ce qu'il y ait interruption ou arrΩt par un
  1082. ΘvΘnement.
  1083.  
  1084. Avec l'option -i, les instructions s'exΘcutent pas α pas ; sinon, ce
  1085. sont les commentaires qui s'exΘcutent pas α pas. Avec l'option -o, les
  1086. routines appelΘes sont traitΘes comme une seule instruction, sinon, les
  1087. routines appelΘes sont Θgalement exΘcutΘes pas α pas.
  1088.  
  1089. L'option -f indique que le dΘbogueur attendra jusqu'α ce que le chemin
  1090. d'exΘcution ou le processus s'arrΩte avant de redonner le contr⌠le
  1091. α l'utilisateur ; c'est-α-dire qu'il exΘcutera le chemin
  1092. d'exΘcution ou le processus en avant-plan. L'option -b indique une
  1093. exΘcution en arriΦre-plan (sans attente). Le chemin d'exΘcution ou le
  1094. processus est lancΘ, mais le contr⌠le est redonnΘ immΘdiatement α
  1095. l'utilisateur. Si aucune des deux options (-f ou -b) est spΘcifiΘ, la
  1096. valeur par dΘfaut est donnΘe en fonction de la valeur de la variable
  1097. interne du dΘbogueur %wait.
  1098.  
  1099. L'option -q indique que l'exΘcution pas α pas doit Ωtre 'discrΦte' ; le
  1100. dΘbogueur n'affiche pas l'id du processus en cours d'exΘcution et
  1101. n'imprime pas la ligne du code source qui va Ωtre exΘcutΘ.
  1102.  
  1103. Notez que les chemins d'exΘcution qui ne sont pas exΘcutΘs sur un noyau
  1104. de taille rΘduite ne peuvent pas Ωtre lancΘs (de tels chemins
  1105. d'exΘcution s'affiche avec l'Θtat "Off LWP" lors de la commande "ps").
  1106.  
  1107. EXEMPLES
  1108. step -io
  1109. step -b
  1110. step -p all -c 10
  1111.  
  1112. VOIR EGALEMENT
  1113. %verbose, %wait, processus, liste_proc, ps, run, thread
  1114. ++
  1115.  
  1116.  
  1117. ++ halt
  1118. NOM
  1119. halt - arrΩte le chemin d'exΘcution ou le processus exΘcutΘ en arriΦre-plan.
  1120.  
  1121. RESUME
  1122. halt [-p liste_proc]
  1123.  
  1124. DESCRIPTION
  1125. Le dΘbogueur indique α chaque chemin d'exΘcution ou α chaque processus
  1126. ne comportant qu'un seul chemin d'exΘcution (%thread ou %proc par dΘfaut),
  1127. qu'il doit suspendre son exΘcution immΘdiatement. Cette requΩte
  1128. n'est pas exΘcutΘe sur le champ, en raison des temps d'attente du systΦme
  1129. ou des variations dans l'exΘcution des taches.
  1130.  
  1131. La commande "halt" n'est pas trΦs utile pour les processus ou pour les
  1132. chemins d'exΘcution qui s'exΘcutent en avant-plan, puisque le
  1133. dΘbogueur ne redonne pas le contr⌠le α l'utilisateur jusqu'α l'arrΩt de
  1134. ces chemins d'exΘcution ou de ces processus. Pour arrΩter un chemin
  1135. d'exΘcution ou un processus qui s'exΘcute en avant-plan tapez la touche
  1136. interruption (gΘnΘralement "Suppr.").
  1137.  
  1138. VOIR EGALEMENT
  1139. %wait, liste_proc, run, step
  1140. ++
  1141.  
  1142. ++ syscall
  1143. NOM
  1144. syscall - mets en place le suivi des appels systΦmes.
  1145.  
  1146. RESUME
  1147. syscall [-p liste_proc] [[-eqx] [-c nombre] call ... [commande]]
  1148.  
  1149. DESCRIPTION
  1150. Indique les actions α prendre lorsqu'un chemin d'exΘcution ou un processus
  1151. entre (ou sort) d'un appel systΦme. Sans arguments, cette commande
  1152. affiche la liste des appels pour les chemins d'exΘcution ou les
  1153. processus nommΘs.
  1154.  
  1155. Si plusieurs noms (ou numΘros) d'appel systΦme sont spΘcifiΘs, le
  1156. dΘbogueur suspendra le chemin d'exΘcution ou le processus en entrΘe (-e,
  1157. par dΘfaut) et/ou en sortie (-x) d'un appel systΦme. L'ΘvΘnement appel
  1158. systΦme sera annoncΘ et les "commandes" associΘes seront alors exΘcutΘes.
  1159.  
  1160. L'option -q spΘcifie un comportement discret: l'ΘvΘnement ne sera pas
  1161. annoncΘ. L'option -c spΘcifie que l'ΘvΘnement pourra se dΘclencher
  1162. "nombre" fois avant que le dΘbogueur ne suspende le chemin d'exΘcution
  1163. ou le processus. Le chemin d'exΘcution ou le processus sera suspendu α
  1164. chaque occurence suivante.
  1165.  
  1166. Utilisez "help sysnames" pour obtenir une liste des noms des appels
  1167. systΦmes corrects, les majuscules et les minuscules n'Θtant pas prise
  1168. en compte.
  1169.  
  1170. A la diffΘrence de ce qui se produit pour d'autres commandes, si
  1171. l'option -p n'est pas spΘcifiΘe α la commande syscall, ses actions
  1172. s'appliquent α tous les chemins d'exΘcutions et α tous les processus
  1173. dΘrivΘs du programme actuel (%program).
  1174.  
  1175. EXEMPLES
  1176. syscall -c 10 write { if (fd == 5) run }
  1177. syscall -qx read
  1178.  
  1179. VOIR EGALEMENT
  1180. %program, assoccmd, delete, disable, enable, events, liste_proc
  1181. ++
  1182.  
  1183.  
  1184. ++ regs
  1185. NOM
  1186. regs - affiche le contenu des registres du processeur.
  1187.  
  1188. RESUME
  1189. regs [-p liste_proc]
  1190.  
  1191. DESCRIPTION
  1192. Affiche en hexadΘcimal le contenu des regitres du processeur pour les
  1193. chemins d'exΘcution et les processus spΘcifiΘs (par dΘfaut %thread
  1194. ou %proc).
  1195.  
  1196. VOIR EGALEMENT
  1197. dis, dump, liste_proc
  1198. ++
  1199.  
  1200.  
  1201. ++ stack
  1202. NOM
  1203. stack - affiche le retour des appels de fonction.
  1204.  
  1205. RESUME
  1206. stack [-p liste_proc] [-f trame] [-c nombre] [-a address ] [ -s pile ]
  1207.  
  1208. DESCRIPTION
  1209. Affiche les fonctions actives pour la liste des chemins
  1210. d'exΘcution et des processus (%thread ou %proc par dΘfaut). Les fonctions
  1211. sont affichΘes avec leurs noms, les noms des arguments et leurs
  1212. valeurs, ainsi que la ligne en cours d'exΘcution ou l'adresse α
  1213. l'intΘrieur de la fonction. Les noms des fonctions, les noms des
  1214. arguments et le numΘro de ligne ne sont peut Ωtre pas disponibles s'il
  1215. n'y a pas d'informations symboliques suffisantes.
  1216.  
  1217. "nombre" est le nombre de trames α afficher. Si ce chiffre n'est pas
  1218. spΘcifiΘ, la commande affiche la totalitΘ de la pile. L'option -f
  1219. indique le numΘro de la trame qui dΘbutera l'affichage. Les trames sont
  1220. numΘrotΘes α partir de 0 en partant du bas de la pile
  1221. (trame initiale).
  1222.  
  1223. Les options -a et -s vous permettent de spΘcifier une adresse de dΘpart
  1224. (compteur du programme) et/ou une valeur de dΘpart pour le pointeur
  1225. de la pile. Ceci est parfois utile lorsque l'on essaye d'obtenir
  1226. un traτage de la pile pour un processus qui a effectuΘ un saut α une
  1227. adresse non-admise ou un processus dont le pointeur de pile a ΘtΘ altΘrΘ.
  1228. Ces deux options ont besoin d'une adresse en base hexadΘcimale.
  1229.  
  1230. EXEMPLES
  1231. stack -p p2
  1232. stack -f 2 -c 3
  1233. stack -a 0x80494958 -s 0xbfff8004
  1234.  
  1235. VOIR EGALEMENT
  1236. liste_proc
  1237. ++
  1238.  
  1239. ++ while
  1240. NOM
  1241. while - boucle conditionnelle.
  1242.  
  1243. RESUME
  1244. while (expr) cmd
  1245.  
  1246. DESCRIPTION
  1247. L'expression ("expr") est ΘvaluΘe dans le langage actuel (%lang ou
  1248. %db_lang) dans le contexte du chemin d'exΘcution actuel ou du processus
  1249. ne comportant qu'un seul chemin d'exΘcution. Si cette expression
  1250. est vraie, la commande ("cmd") est exΘcutΘe. La sΘquence est ensuite
  1251. rΘpΘtΘe. La commande ("cmd") peut Ωtre une commande unique ou un bloc.
  1252.  
  1253. EXEMPLES
  1254. while ($foo < 10) { print $foo, a[$foo]; set $foo = $foo + 1 }
  1255.  
  1256. VOIR EGALEMENT
  1257. %db_lang, %lang, bloc, break, continue, expr, if, scope
  1258. ++
  1259.  
  1260.  
  1261. ++ cd
  1262. NOM
  1263. cd - change le rΘpertoire de travail actuel.
  1264.  
  1265. RESUME
  1266. cd [rΘpertoire]
  1267.  
  1268. DESCRIPTION
  1269. cd change le rΘpertoire de travail actuel du dΘbogueur en celui qui
  1270. est spΘcifiΘ par "rΘpertoire". Si aucun rΘpertoire n'est donnΘ, cd utilise
  1271. le rΘpertoire spΘcifiΘ par la variable d'environnement HOME.
  1272.  
  1273. VOIR EGALEMENT
  1274. pwd
  1275. ++
  1276.  
  1277. ++ change
  1278. NOM
  1279. change - modifie un ΘvΘnement existant.
  1280.  
  1281. RESUME
  1282. change numΘro_ΘvΘnement [-p liste_proc] [-evqx] [-c nombre]
  1283.         [expr_stop|call...|signal...] [{commandes}]
  1284.  
  1285. DESCRIPTION
  1286. numΘro_ΘvΘnement est le numΘro d'un ΘvΘnement existant et correct, et il doit
  1287. Ωtre placΘ en premier. Les autres options vous permettent de modifier
  1288. les diffΘrents attributs d'un ΘvΘnement:
  1289. 1) la liste des chemins d'exΘcutions et des processus auxquels
  1290.    s'appliquent l'ΘvΘnement (-p),
  1291. 2) le niveau de dΘtail des messages donnΘs (-q Θtant un ΘvΘnement
  1292.    'discret', -v un ΘvΘnement dΘtaillΘ),
  1293. 3) pour les appels systΦmes, si l'ΘvΘnement se produit en entrΘe, en
  1294.    sortie ou les deux (-ex),
  1295. 4) pour les arrΩts et les appels au systΦme, le nombre de fois qu'un
  1296.    ΘvΘnement se produit avant d'Ωtre annoncΘ (-c),
  1297. 5) les commandes associΘes (qui doivent Ωtre mises entre
  1298.    accolades {}),
  1299. 6) l'expression, la liste des appels systΦmes et la liste des signaux
  1300.    associΘes α l'ΘvΘnement.
  1301.  
  1302. EXEMPLES
  1303. change 3 -q
  1304. change 5 -p p2 -c 10
  1305. change 7 { print "x == ", x }
  1306. change 9 -x write
  1307.  
  1308. VOIR EGALEMENT
  1309. assoccmd, delete, disable, enable, events, onstop,
  1310. liste_proc, signal, stop, syscall
  1311. ++
  1312.  
  1313. ++ export
  1314. NOM
  1315. export - ajoute un ensemble nom/valeur α l'environnement.
  1316.  
  1317. RESUME
  1318. export $username
  1319.  
  1320. DESCRIPTION
  1321. La commande export exporte une variable dΘfinie par l'utilisateur et 
  1322. gΘrΘe par le dΘbogueur dans l'environnement. La variable "username" , 
  1323. ainsi que sa valeur actuelle, font alors partie de l'environnement qui 
  1324. est reτu par le processus crΘΘ par le dΘbogueur. Si la valeur de 
  1325. $username change, elle doit Ωtre exportΘe de nouveau, afin que la 
  1326. nouvelle valeur fasse partie de l'environnement. Notez que "username" 
  1327. est exportΘe sans le prΘfixe "$".
  1328.  
  1329. VOIR EGALEMENT
  1330. uservars
  1331. ++
  1332.  
  1333. ++ fc
  1334. NOM
  1335. fc - recherche, modifie et exΘcute de nouveau des commandes.
  1336.  
  1337. RESUME
  1338. fc [-e ename] [-nlr] [premiΦre [derniΦre]]
  1339. fc -e - [old=new] [commande]
  1340.  
  1341. DESCRIPTION
  1342. "fc" permet d'utiliser des commandes d'Θdition et de rappel de style
  1343. ksh(1). Sous sa premiΦre syntaxe, un groupe de commandes de "premiΦre" 
  1344. α "derniΦre" sont sΘlectionnΘes α partir des derniΦres commandes 
  1345. HISTSIZE qui ont ΘtΘ entrΘes. Les arguments "premiΦre" et "derniΦre"
  1346. peuvent Ωtre spΘcifiΘs, soit en tant que chaεne de caractΦres, soit en
  1347. tant que numΘros. Une chaεne de caractΦres est utilisΘe pour localiser
  1348. les commandes les plus rΘcentes en commenτant par la chaεne spΘcifiΘe.
  1349. Un chiffre nΘgatif peut Ωtre donnΘ en tant que dΘcalage α partir du
  1350. numΘro de la commande actuelle.
  1351.  
  1352. Si l'option -l est spΘcifiΘe, les commandes sont affichΘes sur la sortie
  1353. standard. Autrement, l'Θditeur "ename" est lancΘ sur un fichier
  1354. temporaire contenant les commandes. Si "ename" n'est pas fourni, la valeur
  1355. de la variable d'environnement FCEDIT (par dΘfaut: /usr/bin/ed)
  1356. est utilisΘe comme Θditeur. Lorsque l'Θdition est terminΘe, les commandes
  1357. ΘditΘes sont exΘcutΘes.
  1358.  
  1359. Si "premiΦre" n'est pas spΘcifiΘe, la valeur par dΘfaut est la commande
  1360. prΘcΘdente pour l'Θdition et -16 pour l'affichage. L'option -r inverse
  1361. l'ordre des commandes ; l'option -n supprime le numΘro des commandes
  1362. lors de l'affichage.
  1363.  
  1364. Dans sa deuxiΦme syntaxe, la "commande" est exΘcutΘe de nouveau
  1365. aprΦs que la substitution "old=new" (ancienne=nouvelle) ait eu lieu. Si
  1366. la commande n'est pas spΘcifiΘe, la valeur par dΘfaut est la commande
  1367. prΘcΘdente.
  1368.  
  1369. VOIR EGALEMENT
  1370. %mode
  1371. ++
  1372.  
  1373. ++ logoff
  1374. NOM
  1375. logoff - arrΩte la consignation des sessions.
  1376.  
  1377. RESUME
  1378. logoff
  1379.  
  1380. DESCRIPTION
  1381. Arrete la consignation des sessions.
  1382.  
  1383. VOIR EGALEMENT
  1384. logon
  1385. ++
  1386.  
  1387.  
  1388. ++ logon
  1389. NOM
  1390. logon - lance la consignation des sessions.
  1391.  
  1392. RESUME
  1393. logon [fichier_consignation]
  1394.  
  1395. DESCRIPTION
  1396. Lance la consignation des sessions. Toutes les sorties du dΘbogueur
  1397.  sont envoyΘes dans un "fichier de consignation". Chaque
  1398. ligne de sortie est prΘcΘdΘe d'un signe "#" (commentaire). Les commandes
  1399. du dΘbogueur sont Θgalement envoyΘes dans le fichier de consignation, 
  1400. mais sans Ωtre prΘcΘdΘes du signe "#". Si le nom d'un fichier de 
  1401. consignation n'est pas spΘcifiΘ, le dernier fichier de consignation 
  1402. utilisΘ par la session de dΘbogage actuelle est celui qui sera utilisΘ. 
  1403. Les nouvelles commandes et les nouvelles sorties sont ajoutΘes α ce 
  1404. fichier. Les fichiers de consignation peuvent Ωtre utilisΘs comme script 
  1405. de commande pour le dΘbogueur.
  1406.  
  1407. VOIR EGALEMENT
  1408. logoff, script
  1409. ++
  1410.  
  1411.  
  1412. ++ onstop
  1413. NOM
  1414. onstop - indique l'action α exΘcuter lors de l'arrΩt d'un chemin
  1415. d'exΘcution ou d'un processus.
  1416.  
  1417. RESUME
  1418. onstop [-p liste_proc] [commande]
  1419.  
  1420. DESCRIPTION
  1421. Sans argument "commande", affiche la liste des actions "onstop" actuelles, 
  1422. pour la liste des chemins d'exΘcution ou des processus spΘcifiΘs en 
  1423. "liste_proc".
  1424.  
  1425. "commande" peut Ωtre une seule commande ou un bloc de commande. Si une
  1426. commande ou un bloc est indiquΘ, ces commandes sont exΘcutΘes α chaque
  1427. arrΩt d'un chemin d'exΘcution ou d'un processus spΘcifiΘ. (dans le contexte
  1428. de ce chemin d'exΘcution ou de ce processus). L'arrΩt comprend les
  1429. exΘcutions pas α pas et les arrΩts pour un autre ΘvΘnement du
  1430. dΘbogueur (signal, syscall, stop).
  1431.  
  1432. A la diffΘrence de ce qui se produit pour la plupart des autres
  1433. commandes, si l'option -p n'est pasfournie α la commande "onstop" celle-ci
  1434. va s'appliquer α tous les chemins d'exΘcution et α tous les processus
  1435. dΘrivΘs du programme actuel (%program).
  1436.  
  1437. EXEMPLES
  1438. onstop -p p2
  1439. onstop { print i, x[i] }
  1440.  
  1441. VOIR EGALEMENT
  1442. %program, delete, disable, enable, events, signal, stop, syscall
  1443. ++
  1444.  
  1445. ++ rename
  1446. NOM
  1447. rename - change le nom sous lequel un programme est connu.
  1448.  
  1449. RESUME
  1450. rename nom_prog nom
  1451.  
  1452. DESCRIPTION
  1453. Lorsqu'un processus est crΘΘ ou fait l'objet de la fonction "grab",
  1454. le nom de l'exΘcutable dont dΘrive le processus peut Ωtre utilisΘ
  1455. pour faire rΘfΘrence α tous les chemins d'exΘcution et α tous les
  1456. processus dΘrivant de cet exΘcutable et peut Θgalement Ωtre utilisΘ dans
  1457. toutes les liste_proc. "rename" spΘcifie le nouveau nom de ce programme.
  1458.  
  1459. VOIR EGALEMENT
  1460. create, grab, liste_proc
  1461. ++
  1462.  
  1463. ++ %file
  1464. NOM
  1465. %file - le fichier source actuel.
  1466.  
  1467. DESCRIPTION
  1468. %file est dΘfinie par le nom du fichier source associΘ α la trame
  1469. actuelle (le cas ΘchΘant), α chaque fois qu'un chemin d'exΘcution ou qu'un
  1470.  processus ne comportant qu'un seul chemin d'exΘcution s'arrΩte ou que
  1471. %frame est modifiΘ. Chaque chemin d'exΘcution ou chaque processus ne
  1472. comportant qu'un seul chemin d'exΘcution, possΦde son propre %file. La
  1473. premiΦre commande "list" aprΦs la dΘfinition de %frame affichera le code
  1474. source provenant de %file si aucun nom de fichier n'est spΘcifiΘ. Vous
  1475. ne pouvez pas changer %file de faτon explicite.
  1476.  
  1477. VOIR EGALEMENT
  1478. %frame, %line, %list_file, %list_line, list
  1479. ++
  1480.  
  1481. ++ %follow
  1482. NOM
  1483. %follow - est-ce que le dΘbogueur doit suivre les processus enfants ?
  1484.  
  1485. DESCRIPTION
  1486. Le dΘbogueur contr⌠le pour l'utilisateur les processus qui ont ΘtΘ
  1487. crΘΘs par le dΘbogueur (avec la commande "create"), ou pris en charge
  1488. (avec la commande "grab") alors qu'il Θtait dΘja en train de
  1489. s'exΘcuter. Si %follow est suivi soit de "all" soit de "procs", le
  1490. dΘbogueur prend Θgalement le contr⌠le des processus enfant de tout les
  1491. processus sous contr⌠le qui utilisent la duplication ("fork"). Si %follow
  1492. est suivi de "none", aucun processus enfant ne sera controlΘ. Le mode
  1493. global de contr⌠le mis en place par %follow peut Ωtre remplacΘ par des
  1494. commandes "create" ou "grab" individuelles. Tous les processus contr⌠lΘs
  1495.  peuvent Ωtre libΘrΘs avec la commande "release".
  1496.  
  1497. La valeur par dΘfaut de %follow est "all".
  1498.  
  1499. Tous les chemins d'exΘcution crΘΘs par un processus sujet seront suivis par
  1500. le dΘbogueur (mais peuvent Ωtre libΘrΘs du contr⌠le du dΘbogueur en
  1501. utilisant la commande "release"). Voir la description de %thread_change
  1502. pour plus d'informations sur la maniΦre de contr⌠ler le comportement
  1503. du dΘbogueur en ce qui concerne les nouveaux chemins d'exΘcution.
  1504.  
  1505. VOIR EGALEMENT
  1506. create, grab, processus, release, set, %thread_change
  1507. ++
  1508.  
  1509. ++ %frame
  1510. NOM
  1511. %frame - le numΘro de la trame actuelle dans la pile d'appel.
  1512.  
  1513. RESUME
  1514. La portΘe des listings sources, des tables de symboles, du
  1515. dΘsassemblage et de l'Θvaluation des expressions. %frame est dΘfinie par
  1516. le numΘro de la trame le plus ΘlevΘ (en partant de 0 pour la trame
  1517. initiale). Chaque fois qu'un chemin d'exΘcution ou qu'un processus ne
  1518. comportant qu'un seul chemin d'exΘcution possΦde son propre %frame.
  1519. Vous pouvez mettre %frame de maniΦre explicite, α l'aide de la commande
  1520. "set". Donner une valeur α %frame remet Θgalement α zΘro les variables
  1521. %db_lang, %file, %func, %line, %list_file, %list_line et %loc afin de
  1522. maintenir une vue logique du contexte actuel.
  1523.  
  1524. VOIR EGALEMENT
  1525. %db_lang, %file, %func, %line, %loc
  1526. ++
  1527.  
  1528.  
  1529. ++ %func
  1530. NOM
  1531. %func - la fonction actuelle.
  1532.  
  1533. DESCRIPTION
  1534. %func contient le nom de la fonction correspondant α la trame
  1535. actuelle (%frame) α chaque fois qu'un chemin d'exΘcution ou qu'un processus
  1536. ne comportant qu'un seul chemin d'exΘcution s'arrΩte ou que %frame
  1537. est redΘfinie. Chaque chemin d'exΘcution ou processus ne comportant
  1538. qu'un seul chemin d'exΘcution possΦde sa propre %func. Vous pouvez
  1539. modifier de faτon explicite la valeur de %func, avec la commande "set",
  1540. mais seulement pour une fonction qui possΦde une trame active sur la pile;
  1541. %frame (ainsi que les variables associΘes %db_lang, %file, %func,
  1542. %line, %list_file, %list_line et %loc) seront Θgalement modifiΘes
  1543. pour reflΘter le nouveau contexte.
  1544.  
  1545. VOIR EGALEMENT
  1546. %frame
  1547. ++
  1548.  
  1549.  
  1550. ++ %lang
  1551. NOM
  1552. %lang - le langage actuel.
  1553.  
  1554. DESCRIPTION
  1555. Le langage actuel. Dans le cas o∙ il est dΘfini, il remplace la valeur
  1556. de %db_lang. Les chaεnes de caractΦres correctes pour %lang sont les
  1557. suivantes:
  1558.         C     ANSI C
  1559.         C++     C++Release 2 ou 3
  1560. Si %lang n'est pas indiquΘ ou possΦde une valeur nulle (""), le
  1561. dΘbogueur utilise %db_lang comme langage actuel. Parmi les comandes qui
  1562. utilisent %lang pour Θvaluer les expressions il y a if, print, set,
  1563. stop, whatis, while.
  1564.  
  1565. VOIR EGALEMENT
  1566. %db_lang, C++, expr
  1567. ++
  1568.  
  1569. ++ %loc
  1570. NOM
  1571. %loc - l'emplacement actuel.  
  1572.  
  1573. DESCRIPTION
  1574. Indique l'emplacement actuel de l'exΘcution. %loc contient la valeur du
  1575. "program counter" de la trame actuelle lorsqu'un chemin d'exΘcution
  1576. ou un processus ne comportant qu'un seul chemin d'exΘcution s'arrΩte ou
  1577. lorsque %frame est redΘfini. Chaque chemin d'exΘcution ou chaque
  1578. processus ne comportant qu'un seul chemin d'exΘcution possΦde son propre
  1579. %loc. Vous ne pouvez pas modifier de faτon explicite %loc. La premiΦre
  1580. commande "dis" aprΦs la dΘfinition de %frame va dΘsassembler les
  1581. instructions, commenτant α %loc si aucun emplacement n'est indiquΘ de
  1582. faτon explicite.
  1583.  
  1584. VOIR EGALEMENT
  1585. %frame, dis
  1586. ++
  1587.  
  1588. ++ %list_file
  1589. NOM
  1590. %list_file - le nom du fichier qui a ΘtΘ listΘ en dernier.
  1591.  
  1592. DESCRIPTION
  1593. %list_file garde une trace du dernier fichier affichΘ par la commande
  1594. list. %list-file change α chaque fois que la commande list est exΘcutΘe
  1595. et revient sur le nom du fichier contenant l'emplacement actuel (%loc) dans
  1596. la trame actuelle (%frame) α chaque fois qu'un chemin d'exΘcution
  1597. (ou un processus ne contenant qu'un seul chemin d'exΘcution) s'arrΩte ou
  1598. que %frame est modifiΘe. Chaque  chemin d'exΘcution (ou chaque
  1599. processus ne contenant qu'un seul chemin d'exΘcution) possΦde sa propre
  1600. %list_file.
  1601.  
  1602. VOIR EGALEMENT
  1603. %file, %frame, %line, %list_line, list
  1604. ++
  1605.  
  1606. ++ %list_line
  1607. NOM
  1608. %list_line - affiche le numΘro de la derniΦre ligne affichΘe.
  1609.  
  1610. DESCRIPTION
  1611. %list_line garde une trace de la derniΦre ligne affichΘe par la commande
  1612. "list". %list_line change α chaque fois que la commande "list" est
  1613. exΘcutΘe et Θgalement redΘfinie par le numΘro de la ligne contenant
  1614. l'emplacement actuel (%loc) dans la trame actuelle (%frame) α chaque fois
  1615. qu'un chemin d'exΘcution ou un processus ne comportant qu'un seul chemin
  1616. d'exΘcution s'arrΩte ou que %frame est modifiΘe. Chaque chemin
  1617. d'exΘcution ou processus ne comportant qu'un seul chemin
  1618. d'exΘcution possΦde sa propre %list_line.
  1619.  
  1620. VOIR EGALEMENT
  1621. %file, %frame, %line, %list_file, list
  1622. ++
  1623.  
  1624. ++ %line
  1625. NOM
  1626. %line - le numΘro de la ligne actuelle.
  1627.  
  1628. DESCRIPTION
  1629. %line est dΘfinie par le numΘro de la ligne qui contient l'emplacement
  1630. actuel (%loc) dans la trame courante (%frame) α chaque fois qu'un
  1631. chemin d'exΘcution ou qu'un processus ne comportant qu'un seul chemin
  1632. d'exΘcution s'arrΩte ou que %frame est changΘe. Chaque chemin
  1633. d'exΘcution ou processus ne comportant qu'un seul chemin d'exΘcution
  1634. possΦde son propre %line. La premiΦre commande "list" aprΦs la
  1635. modification de %frame, va afficher le code source en commenτant par %line
  1636. si aucun emplacement n'est indiquΘ. Vous ne pouvez pas modifier %line
  1637. de maniΦre explicite.
  1638.  
  1639. VOIR EGALEMENT
  1640. %frame, %file, %list_file, %list_line, list
  1641. ++
  1642.  
  1643. ++ %mode
  1644. NOM
  1645. %mode - le mode d'Θdition de la ligne actuelle.
  1646.  
  1647. DESCRIPTION
  1648. Debug gΦre les historiques de commandes (ainsi que l'Θdition des commandes)
  1649. du style ksh(1). %mode est le mode d'Θdition utilisΘ pour l'Θdition des
  1650. lignes de commande. %mode contient la valeur de la variable
  1651. d'environnement VISUAL ou, si cette derniΦre n'existe pas, la valeur de
  1652. la variable d'environnement EDITOR. Cette valeur peut Ωtre modifiΘe α
  1653. tout moment en utilisant la commande "set". Les valeurs correctes
  1654. sont "vi" et "emacs". Toute autre valeur de %mode interdira l'Θdition
  1655. des commandes.
  1656.  
  1657. VOIR EGALEMENT
  1658. fc
  1659. ++
  1660.  
  1661. ++ %path
  1662. NOM
  1663. %path - le chemin de recherche local pour les fichiers sources.
  1664.  
  1665. DESCRIPTION
  1666. Chaque programme possΦde son propre %path. La valeur de %path est
  1667. une liste de noms de rΘpertoires, sΘparΘs par deux points. Lorsque le
  1668. dΘbogueur tente d'afficher les lignes de code source α partir d'un fichier,
  1669. il va chercher dans les rΘpertoires indiquΘs dans %path un fichier avec
  1670. le nom correct. Apres avoir recherchΘ la liste des chemins d'accΦs
  1671. locaux pour le programme indiquΘ, le dΘbogueur va chercher dans sa liste
  1672. globale de chemin d'accΦs (%global_path).
  1673.  
  1674. VOIR EGALEMENT
  1675. %global_path
  1676. ++
  1677.  
  1678. ++ %proc
  1679. NOM
  1680. %proc - le processus actuel.
  1681.  
  1682. DESCRIPTION
  1683. Cette variable contient le nom du processus actuel. Il peut Ωtre modifiΘ
  1684. de maniΦre explicite avec la commande "set" ou de faτon implicite
  1685. avec les commandes "create", "grab" ou "release". Modifier %proc modifie
  1686. Θgalement de faτon implicite %program, %thread et %frame.
  1687.  
  1688. VOIR EGALEMENT
  1689. %frame, %program, %thread, liste_proc
  1690. ++
  1691.  
  1692. ++ %program
  1693. NOM
  1694. %program - le programme actuel.
  1695.  
  1696. DESCRIPTION
  1697. Cette variable comporte le nom du programme qui contient le processus
  1698. actuel (%proc). Vous pouvez modifier ce nom de faτon explicite en utilisant
  1699. la commande "set" ou de faτon implicite avec les commandes "create",
  1700. "grab" ou "release". Les programmes sont nommΘs d'aprΦs le fichier
  1701. exΘcutable dont ils dΘrivent et peuvent Ωtre renommΘs avec la commande
  1702. "rename". La dΘfinition de %program redΘfinit Θgalement de faτon
  1703.  implicite %proc, %thread et %frame.
  1704.  
  1705. VOIR EGALEMENT
  1706. %frame, %proc, %thread, liste_proc
  1707. ++
  1708.  
  1709. ++ %prompt
  1710. NOM
  1711.  %prompt - l'invite du dΘbogueur.
  1712.  
  1713. DESCRIPTION
  1714. Le dΘbogueur demande α l'utilisateur une entrΘe en affichant la valeur
  1715. de %prompt. La valeur par dΘfaut est "debug>". Vous pouvez changer la
  1716. valeur de %prompt avec la commande "set".
  1717. ++
  1718.  
  1719. ++ %thisevent
  1720. NOM
  1721. %thisevent - le numΘro de l'ΘvΘnement qui est gΘrΘ actuellement.
  1722.  
  1723. DESCRIPTION
  1724. Avec une commande associΘe, %thisevent Θvaluera le numΘro de l'ΘvΘnement
  1725. auquel les commandes sont associΘes. Vous ne pouvez pas modifier la
  1726. valeur de %thisevent de maniΦre explicite.
  1727.  
  1728. VOIR EGALEMENT
  1729. %lastevent, assoccmd
  1730. ++
  1731.  
  1732.  
  1733. ++ %lastevent
  1734. NOM
  1735. %lastevent - le numΘro de l'ΘvΘnement crΘΘ le plus rΘcent.
  1736.  
  1737. DESCRIPTION
  1738. Apres une commande qui alloue un numΘro d'ΘvΘnement (stop, signal, 
  1739. syscall ou onstop), %lastevent Θvaluera jusqu'αu numΘro qui vient
  1740. d'Ωtre allouΘ. Vous ne pouvez pas modifier la valeur de %lastevent de
  1741. maniΦre explicite.
  1742.  
  1743. VOIR EGALEMENT
  1744. %thisevent
  1745. ++
  1746.  
  1747.  
  1748. ++ assoccmd
  1749. NOM
  1750. assoccmd - une commande du dΘbogueur ou un bloc.
  1751.  
  1752. DESCRIPTION
  1753. Plusieurs commandes acceptent de maniΦre optionnelle une commande ou
  1754. des blocs de commandes associΘs. Ces commandes doivent apparaitre
  1755. en dernier dans la liste des arguments et comprendre des commandes
  1756. possΘdant leurs propres comandes associΘes - ce qui revient α dire que
  1757. les commandes associΘes peuvent Ωtre imbriquΘes. Les commandes seront
  1758. exΘcutΘesα chaque fois que les ΘvΘnements en cause (stop, signal, etc.) se
  1759.  produiront. A l'intΘrieur d'une commande associΘe, %thisevent contient
  1760. le numΘro de l'ΘvΘnement traitΘ. Le chemin d'exΘcution ou le processus
  1761. qui rencontre l'ΘvΘnement devient temporairement le processus actuel
  1762. lorsque les commandes seront exΘcutΘes.
  1763.  
  1764. VOIR EGALEMENT
  1765. %thisevent, bloc, onstop, signal, stop, syscall
  1766. ++
  1767.  
  1768. ++ bloc
  1769. NOM
  1770. bloc - une liste de commandes.
  1771.  
  1772. DESCRIPTION
  1773. Une commande ou une liste de commandes sΘparΘes par des
  1774. points-virgules et entre accolades. Les blocs peuvent Ωtre utilisΘs comme
  1775. commandes associΘes (which see) ou peuvent apparaεtre indΘpendamment
  1776. d'autres commandes. Les blocs peuvent Ωtre utilisΘs pour regrouper des
  1777. commandes afin de rediriger leur sortie avec une seule redirection
  1778. (which see).
  1779.  
  1780. EXEMPLES
  1781. { if (i) print *ptr; else print *mptr } > myfile
  1782.  
  1783. VOIR EGALEMENT
  1784. assoccmd, redirection
  1785. ++
  1786.  
  1787. ++ format
  1788. NOM
  1789. format - le format de la sortie de la commande "print".
  1790.  
  1791. DESCRIPTION
  1792. Le format est une chaεne de caractΦres similaire α celle qui est aceptΘe
  1793. par la routine printf du langage C. Chaque format doit avoir
  1794. la syntaxe suivante:
  1795.         %[flags][width][.[precision]][conversion_character]
  1796.         format_character
  1797. Tous les champs doivent avoir la mΩme signification que dans la routine
  1798. printf. La largeur et la prΘcision sont limitΘs α 1024. Les paramΦtres
  1799. depositionnement de printf et les caractΦres au format 'n' ne sont
  1800. pasacceptΘs. Chaque type de format correspond α l'une des expressions
  1801. donnΘesdans la commande print, dans l'ordre dans lequel ils apparaissent
  1802. Les caractΦres qui ne font pas partie des dΘfinitions de format sont
  1803. imprimΘs tel quel. Les caractΦres de formatage ont les significations
  1804. suivantes (les indications marquΘes d'un astΘrisque (*) ne sont peut
  1805. Ωtrepas disponible sur tous les systΦmes):
  1806.         a*,A*   virgule flottante en hexadΘcimal, avec des exposants
  1807.                 dΘcimaux.
  1808.         b*,B*   entier binaire non signΘ
  1809.         C*      CaractΦre large
  1810.         c       caractΦre non signΘ
  1811.         d,i     entier dΘcimal signΘ
  1812.         e,E     virgule flottante du style [-]d.ddde+/-dd
  1813.         f       virgule flottante du style [-]ddd.dddd
  1814.         g,G     virgule flottante dans l'un des styles ci-dessus
  1815.         o       entier octal non signΘ
  1816.         p       void * (pointeur gΘnΘral ; adresse hexadΘcimale)
  1817.         S*      chaεne de caractΦres large
  1818.         s       chaεne de caractΦres
  1819.         u       entier dΘcimal non signΘ
  1820.         x,X     entier hexadΘcimal non signΘ
  1821.         z       dΘbogueur style par dΘfaut pour l'expression
  1822.         %       %
  1823.  
  1824. VOIR EGALEMENT
  1825. print
  1826. ++
  1827.  
  1828. ++ emplacement
  1829. NOM
  1830. emplacement - une adresse dans un chemin d'exΘcution ou dans un processus.
  1831.  
  1832. DESCRIPTION
  1833. La syntaxe d'un indicateur emplacement est la suivante:
  1834.         address[+-constant]
  1835.         [thread id@][nom_fichier@]line
  1836.         [thread id@][nom_fichier@]function[+-constant]
  1837. ou "address" est l'adresse octale ou hexadΘcimale d'un programme et
  1838. "constant" est un entier hexadΘcimal. Le "thread id" peut faire
  1839. rΘfΘrence α un chemin d'exΘcution ou α un processus ne comportant qu'un
  1840. seul chemin d'exΘcution.
  1841.  
  1842. EXEMPLES
  1843. 17              un numΘro de ligne dans le fichier actuel (%file)
  1844. foo.c@17        un numΘro de ligne dans certains autres fichiers
  1845. 0x80801234      une adresse
  1846. main            un nom de fonction ou un label
  1847. main+3          trois octets aprΦs le label
  1848. p1.2@main       un nom de fonction dans le chemin d'exΘcution
  1849. %loc            l'emplacement actuel
  1850. %line           le fichier actuel et le numΘro de ligne
  1851. %r0             un registre
  1852. %r0+80          un registre plus un dΘcalage
  1853. %pc-4           un registre moins un dΘcalage
  1854. $myvar          une variable dΘfinie par l'utilisateur
  1855.  
  1856. VOIR EGALEMENT
  1857. %file, %line, %loc, scope, uservars
  1858. ++
  1859.  
  1860. ++ liste_proc
  1861. NOM
  1862. liste_proc - une liste des noms de processus.
  1863.  
  1864. DESCRIPTION
  1865. Une liste de noms de processus, sΘparΘs par des virgules.
  1866. La plupart des commandes acceptent une "liste_proc" avec l'option -p.
  1867. Une liste de ce genre ne doit pas contenir de blancs.
  1868.  
  1869. Une liste de noms de processus peut Ωtre constituΘ des choses suivantes:
  1870. 1) le mot-clef "all" (tous) indiquant tous les chemins d'exΘcutions et
  1871.    tous les processus,
  1872. 2) un nom choisi par l'utilisateur ou gΘnΘrΘ par le dΘbogueur, indiquant
  1873.    tous les chemins d'exΘcution et tous les processus dΘrivΘs de ce
  1874.    programme,
  1875. 3) un id de processus gΘnΘrΘ par le dΘbogueur, au format pn (par exemple
  1876.   : p1, p2),
  1877. 4) un id de chemin d'exΘcution gΘnΘrΘ par le dΘbogueur, au format pn.n
  1878.    (par exemple: p2.3, p3.1),
  1879. 5) %program, la variable interne au dΘbogueur, indiquant tous les
  1880.    chemins d'exΘcution et tous les processus dΘrivΘs du programme
  1881.    actuel,
  1882. 6) %proc, la variable interne au dΘbogueur, indiquant le processus
  1883.    courant (si celui-ci ne comporte qu'un seul chemin d'exΘcution) ou
  1884.    tous les chemins d'exΘcution dΘrivΘs du processus courant,
  1885. 7) %thread, la variable interne du dΘbogueur, indiquant le chemin
  1886.    d'exΘcution actuel,
  1887. 8) un entier en base dΘcimale, correspondant α l'id du systΦme d'un
  1888.    processus controlΘ et de tous les chemins d'exΘcution en dΘrivant,
  1889. 9) une variable dΘfinie par l'utilisateur (par exemple: $foo) qui
  1890.    possΦde un valeur entiere pouvant Ωtre interprΘtΘe comme Θtant un id
  1891.    de processus systΦme,
  1892. 10) une variable dΘfinie par l'utilisateur, dont la valeur est une
  1893.     chaεne de caractΦres qui peut Ωtre interprΘtΘe comme l'une des
  1894.     valeurs ci-dessus ou comme une liste des valeurs ci-dessus.
  1895.  
  1896. VOIR EGALEMENT
  1897. %proc, %program, %thread, liste_proc, rename, uservars
  1898. ++
  1899.  
  1900. ++ redirection
  1901. NOM
  1902. redirection - changement de la destination de la sortie du dΘbogueur.
  1903.  
  1904. DESCRIPTION
  1905. Une commande ou un bloc de commandes, peut recevoir le suffixe ">",
  1906. suivi d'un nom de fichier ou un "|" et une invite du Shell UNIX(r).
  1907. Ceci entraεne une redirection de la sortie en direction du fichier ou
  1908. l'envoi de cette sortie sur une invite. Vous pouvez Θgalement utiliser
  1909. ">>", qui ajoute la sortie α la fin du fichier, au lieu d'en remplacer
  1910. le contenu, le cas ΘchΘant.
  1911.  
  1912. EXEMPLES
  1913. stack > save.stack
  1914. symbols -gtv | grep int | pg
  1915.  
  1916. VOIR EGALEMENT
  1917. bloc
  1918. ++
  1919.  
  1920. ++ modΦle
  1921. NOM
  1922. modΦle - une expression de recherche de style sh(1).
  1923.  
  1924. DESCRIPTION
  1925. Un ensemble de caractΦres utilisΘ pour filtrer la sortie des commandes
  1926. "symbols".
  1927.         *       Remplace tous les caractΦres, y compris la chaεne "null".
  1928.         ?       Remplace un seul caractere.
  1929.         [...]   Remplace les caractΦres compris entre les crochets, les
  1930.                 registres Θtant acceptΘs et ! en tant que premier
  1931.                 caractere indiquant la nΘgation
  1932.  
  1933. VOIR EGALEMENT
  1934. symbols
  1935. ++
  1936.  
  1937. ++ expr_rΘg
  1938. NOM
  1939. expr_rΘg - une expression de recherche de style ed(1).
  1940.  
  1941. DESCRIPTION
  1942. Une expression de recherche est utilisΘe pour rechercher un modΦle dans
  1943. un fichier source avec la commande "list".
  1944.         .       Est l'Θquivalent d'un caractere quelconque, α
  1945.                 l'exception d'une fin de ligne
  1946.         [...]   Est l'Θquivalent d'un (ou de plusieurs) des caractΦres
  1947.                 compris entre crochets, les  registres Θtant acceptΘs
  1948.                 et ^ indiquant une nΘgation
  1949.         *       Indique zΘro ou plusieurs occurences des expressions
  1950.                 prΘcΘdentes
  1951.         ^       Est l'Θquivalent du caractere "null" au dΘbut d'une
  1952.                 ligne
  1953.         $       Est l'Θquivalent du caractere "null" α la fin d'une
  1954.                 ligne
  1955.         \{m\}   Est l'Θquivalent de m occurences des expressions
  1956.                 prΘcΘdentes
  1957.         \{m,\}  Indique au moins m occurences des expressions de
  1958.                 recherche prΘcΘdentes
  1959.         \{m,n\} Est l'Θquivalent des occurences de m jusqu'α n (compris)
  1960.         \(...\) Est la mΩme Θquivalence que ...
  1961.         \nombre Est l'Θquivalent de la ΘniΦme expression entre
  1962.                 parenthΦses de la mΩme expression
  1963.         \<      Est l'Θquivalent de la chaεne "null" en dΘbut de mot
  1964.         \>      Est l'Θquivalent de la chaεne "null" α la fin d'un mot
  1965.  
  1966. VOIR EGALEMENT
  1967. list
  1968. ++
  1969.  
  1970. ++ uservars
  1971. NOM
  1972. uservars - variables dΘfinies par l'utilisateur et gΘrΘes par le
  1973. dΘbogueur.
  1974.  
  1975. DESCRIPTION
  1976. Les noms commenτant par dollar ($) sont rΘservΘs α l'utilisateur
  1977. du dΘbogueur. Au dΘmarrage, le dΘbogueur importe l'environnement
  1978.  du shell en tant qu'ensemble initial de variables dΘfinies par
  1979. l'utilisateur. Vous pouvez crΘer une nouvelle variable avec la commande
  1980. "set". Les variables dΘfinies par l'utilisateur sont de type "chaεne de
  1981. caractΦres" ; elles sont converties en valeurs nuΘmriques chaque fois
  1982. que cela est nΘcessaire avec strtol(3).
  1983.  
  1984. VOIR EGALEMENT
  1985. export, set
  1986. ++
  1987.  
  1988. ++ %db_lang
  1989. NOM
  1990. %db_lang - la variable interne du dΘbogueur correspondant
  1991. au langage actuel.
  1992.  
  1993. DESCRIPTION
  1994. %db_lang contient le langage du chemin d'exΘcution ou du processus
  1995. actuel et elle est utilisΘe par le dΘbogueur afin d'Θvaluer les
  1996. expressions du langage. Elle est dΘfinie par le dΘbogueur, qui se fonde
  1997. sur les informations contenues dans le fichier source lui-mΩme et elle
  1998. ne peut pas Ωtre modifiΘe directement par l'utilisateur. Si le
  1999. dΘbogueur ne peut pas dΘterminer le langage du chemin d'exΘcution ou du
  2000. processus courant, la valeur par dΘfaut de %db_lang est C. DΘfinir de
  2001. maniΦre explicite la variable %lang remplace le langage du chemin
  2002. d'exΘcution ou du processus actuel. Les commandes utilisant %db_lang
  2003. pour Θvaluer les expressions sont: if, print, set, stop, whatis,
  2004. and while, entre autre.
  2005.  
  2006. VOIR EGALEMENT
  2007. %lang, C++, expr
  2008. ++
  2009.  
  2010. ++ %global_path
  2011. NOM
  2012. %global_path - le chemin de recherche global du dΘbogueur.
  2013.  
  2014. DESCRIPTION
  2015. La valeur de %global_path doit Ωtre une liste de noms de rΘpertoires,
  2016. sΘparΘs par deux points (":"). Lorsque le dΘbogueur tente d'afficher
  2017. le code source provenant d'un fichier, il va chercher dans les
  2018. rΘpertoires indiquΘs par le %path local les fichiers portant le mΩme nom
  2019. que le programme. Apres avoir cherchΘ dans la liste locale, le dΘbogueur
  2020. va chercher dans la liste globale de recherche (%global_path).
  2021. %global_path peut Θgalement Ωtre modifiΘ α l'invite du dΘbogueur avec
  2022. l'option -s.
  2023.  
  2024. VOIR EGALEMENT
  2025. %path
  2026. ++
  2027.  
  2028. ++ %num_bytes
  2029. NOM
  2030. %num_bytes - le nombre d'octets α afficher par dΘfaut.
  2031.  
  2032. DESCRIPTION
  2033. Si la commande "dump" n'est pas donnΘe avec l'option -c, elle n'affiche
  2034. que %num_bytes octets. La valeur initiale de %num_bytes est 256 et
  2035. elle peut Ωtre modifiΘe avec la commande "set".
  2036.  
  2037. VOIR EGALEMENT
  2038. dump
  2039. ++
  2040.  
  2041. ++ %num_lines
  2042. NOM
  2043. %num_lines -- nombre de lignes α afficher.
  2044.  
  2045. DESCRIPTION
  2046. Si la commande "dis" ou la commande "list" sont donnΘes sans l'option -c, 
  2047. chaque commande affiche un nombre de lignes Θquivalent α %num_lines. 
  2048. La valeur initiale de %num_lines est de 10 et cette valeur peut Ωtre 
  2049. modifiΘe avec la commande "set".
  2050.  
  2051. VOIR EGALEMENT
  2052. dis, list
  2053. ++
  2054.  
  2055. ++ %result
  2056. NOM
  2057. %result - Θtat de l'exΘcution de commandes du dΘbogueur.
  2058.  
  2059. DESCRIPTION
  2060. Apres l'exΘcution de chaque commande du dΘbogueur, le rΘsultat de
  2061.  son exΘcution est conservΘ en %result. 0 indique une exΘcution
  2062. rΘussie. Une autre valeur que 0 indique un Θchec lors de l'exΘcution.
  2063. ++
  2064.  
  2065. ++ %verbose
  2066. NOM
  2067. %verbose - niveau de dΘtails des ΘvΘnements du dΘbogueur.
  2068.  
  2069. DESCRIPTION
  2070. Lorsqu'un processus ou un chemin d'exΘcution controlΘ par le dΘbogueur
  2071. s'arrΩte, le dΘbogueur imprime normalement un message indiquant
  2072. la raison de cet arrΩt, l'id du chemin d'exΘcution ou du processus
  2073. et la ligne de code suivant celle ou s'est produit l'arrΩt, le cas ΘchΘant
  2074. ou la ligne suivante de texte dΘsassemblΘ. %verbose peut Ωtre utilisΘ
  2075. pour contr⌠ler cette sortie. Les valeurs possibles sont les
  2076. suivantes:
  2077.         quiet   aucune sortie n'est envoyΘe lors de l'arrΩt d'un
  2078.                 chemin d'exΘcution ou d'un processus
  2079.         source  affiche seulement la ligne de code source ou de
  2080.                 dΘsassemblage
  2081.         events  si un ΘvΘnement a provoquΘ l'arrΩt, l'ΘvΘnement est
  2082.                 Θgalement affichΘ (cette derniΦre option ne prenant pas 
  2083.                 en compte les demandes d'arrΩt (halte ou exΘcution pas α pas)
  2084.         reason  la raison de l'arrΩt, y compris les ΘvΘnements et les
  2085.                 demandes d'arrΩts
  2086.         all     affichage le plus dΘtaillΘ (gΘnΘralement le mΩme que
  2087.                 reason)
  2088.  
  2089. Le mode de fonctionnement par dΘfaut est "all". Le mode "quiet" peut
  2090. Θgalement Ωtre indiquΘ avec l'option -q α certaines commandes du dΘbogueur.
  2091. Ces options -q individuelles remplacent le mode %verbose.
  2092.  
  2093. VOIR EGALEMENT
  2094. change, signal, step, stop, syscall, %thread_change
  2095. ++
  2096.  
  2097. ++ %wait
  2098. NOM
  2099. %wait - exΘcution synchrone ou asychrone des commandes.
  2100.  
  2101. DESCRIPTION
  2102. Lorsque le dΘbogueur lance un chemin d'exΘcution ou un processus ne
  2103. comportant qu'un seul chemin d'exΘcution, il attend normalement
  2104. que le processus ou le chemin d'exΘcution s'arrΩte avant de redonner le
  2105. contr⌠le α l'utilisateur. Donner α %wait la valeur "background",
  2106. 0 ou "no" fait entrer le dΘbogueur en mode asynchrone. En mode asynchrone,
  2107. les commandes exΘcutant un processus ou un chemin d'exΘcution
  2108. redonnent immΘdiatement le contr⌠le α l'utilisateur, sans en attendre
  2109. l'arrΩt. Pour revenir au mode de fonctionnement par dΘfaut, il suffit de
  2110. donner les valeurs "foreground", 1 ou "yes" α %wait. La valeur globale
  2111. de %wait peut Ωtre remplacΘe avec les options -f ou -b des commandes
  2112. "run" et "step".
  2113.  
  2114. VOIR EGALEMENT
  2115. run, step
  2116. ++
  2117.  
  2118. ++ expr_stop
  2119. NOM
  2120. expr_stop - traitement de l'espace adresse des expressions
  2121. d'ΘvΘnements
  2122.  
  2123. DESCRIPTION
  2124. Les expr_stop sont des expressions spΘciales qui sont acceptΘes par la
  2125. commande stop. Une expr_stop consiste en un ou plusieurs ΘvΘnements,
  2126. joints par les opΘrateurs spΘciaux && (and) ou || (or). Ces opΘrateurs
  2127. sont associΘs α gauche (left-associative), mais le dΘbogueur ne garantit
  2128. pas l'ordre dans lequel leurs opΘrandes seront ΘvaluΘs. Chaque ΘvΘnement
  2129. peut Ωtre:
  2130.         emplacement
  2131.         ( expr )
  2132.         *lvalue
  2133.  
  2134. Chaque type d'ΘvΘnement stop possΦde une action qui lui permettra d'Ωtre
  2135. pris en compte par le dΘbogueur. Lorsqu'une action de ce type a lieu,
  2136. l'expression stop toute entiere est ΘvaluΘe afin de dΘterminer si elle est
  2137. "vraie". Si cela est le cas, l'ΘvΘnement se dΘclenche de la maniere
  2138. normale (le dΘbogueur informe alors l'utilisateur de l'ΘvΘnement et exΘcute
  2139. les commandes associΘes).
  2140.  
  2141. Un "emplacement" est l'adresse, α l'intΘrieur du texte du processus o∙
  2142. le dΘbogueur peut placer un point d'arrΩt. Lorsqu'un chemin
  2143. d'exΘcution ou un processus atteint l'emplacement indiquΘ, le dΘbogueur
  2144. prend en compte l'ΘvΘnement. Pour des emplacements de stop_events
  2145. qui font rΘfΘrence α des noms de fonctions, l'expression est vraie aussi
  2146. longtemps que la fonction est active. Pour des emplacements de stop_events
  2147. s'appliquant α une adresse particuliΦre ou α un numΘro de ligne,
  2148. l'expression n'est vraie que lorsque le chemin d'exΘcution ou le processus
  2149.  atteint cette adresse ou cette ligne. Tapez "help emplacement" pour une
  2150.  syntaxe complΦte de la commande emplacement. Lorsque le langage actuel est
  2151.  le C++, vous pouvez Θgalement utiliser des fonctions particuliΦres
  2152.  au C++. Tapez "help C++" pour obtenir plus de dΘtails.
  2153.  
  2154. "expr" peut Ωtre une expression correct dans le langage actuel (%lang ou
  2155. %db_lang). Le dΘbogueur remarque le stop_event lorsque l'un des
  2156. identificateurs compris dans l'expression voit sa valeur modifiΘe.
  2157. L'expression entiere est ensuite ΘvaluΘe dans le contexte du langage actuel.
  2158.  
  2159. "lvalue" peut Ωtre une expression quelconque dans le langage actuel qui
  2160. serait correcte α gauche d'une dΘclaration d'assignement dans ce langage.
  2161. Le dΘbogueur remarque cet ΘvΘnement lorsque le contexte de
  2162. l'emplacement change. Le changement en lui-mΩme rend vrai cette sorte de
  2163. stop_event.
  2164.  
  2165. Des expr_stop plus puissantes peuvent Ωtre crΘΘes en combinant des
  2166. ΘvΘnements_stop avec des opΘrateurs && (and). Par exemple, pour
  2167. s'arrΩter α l'intΘrieur d'une fonction a alors que la fonction b est
  2168. Θgalement active, tapez "stop a && b". Pour s'arrΩter lorsque la valeur
  2169. d'une expression x devient vraie α l'intΘrieur d'une fonction y, tapez
  2170. "stop y && (x)".
  2171.  
  2172. EXEMPLES
  2173. stop myfile.c@230
  2174. stop *bar
  2175. stop (x == 5)
  2176. stop foo && (a > 7)
  2177. stop (a == 4) || (b == 7)
  2178.  
  2179. VOIR EGALEMENT
  2180. %db_lang, %lang, C++, expr, emplacement, scope, stop
  2181. ++
  2182.  
  2183. ++ %redir
  2184. NOM
  2185. %redir - le processus d'E/S doit-il Ωtre redirigΘ ?
  2186.  
  2187. DESCRIPTION
  2188. %redir contr⌠le le comportement de la commande create. Par dΘfaut, la
  2189. commande create ne redirige pas les E/S d'un processus qu'elle vient
  2190. de crΘer, α moins que l'option -r ne soit indiquΘe. Si %redir possΦde
  2191.  la valeur 1 ou "yes", create redirigera les E/S du processus, α
  2192. moins que l'option -n ne soit indiquΘe. Le comportement par dΘfaut peut
  2193. Ωtre remis en place en remettant %redir sur 0 ou sur "no".
  2194.  
  2195. VOIR EGALEMENT
  2196. create, grab, input
  2197. ++
  2198.  
  2199.  
  2200. ++ expr
  2201. NOM
  2202. expr - expressions du dΘbogueur
  2203.  
  2204. DESCRIPTION
  2205. Les expressions du dΘbogueur suivent la syntaxe et la sΘmantique
  2206. du langage actuel (%lang ou %db_lang). Le dΘbogueur accepte les expressions
  2207. contenant des combinaisons de variables et de fonctions du programme,
  2208. de noms qualifiΘs, de variables internes au dΘbogueur et des variables
  2209. internes au dΘbogueur dΘfinies par l'utilisateur. Un nom qualifiΘ
  2210. indique un identificateur du programme qui ne sera pas visible dans le
  2211. contexte actuel. La syntaxe de ces noms qualifiΘs est la suivante:
  2212.         [[thread_id]@][[source_file]@][[function]@][[line_number]
  2213.         @]identifier
  2214.      ou [[thread_id]@]frame_number@identifier
  2215.      ou [[thread_id]@]object_name@[source file@]identifier
  2216.  
  2217. Le nom qualifiΘ est ΘvaluΘ de gauche α droite et il est possible
  2218. d'en rΘduire l'ambiguitΘ en y ajoutant des @ si nΘcessaire.
  2219. "frame_number" (numΘro de trame) et "function" (fonction) doivent
  2220. faire rΘfΘrence aux fonctions qui sont actuellement actives.
  2221. "thread_id" (id_thread) peut faire rΘfΘrence α un
  2222. chemin d'exΘcution ou α un processus ne comportant qu'un seul
  2223. chemin d'exΘcution. "object_name" (nom d'objet) fait rΘfΘrence α
  2224. un objet quelconque (fichier exΘcutable ou librairie partagΘe)
  2225. faisant partie du processus.
  2226.  
  2227. Lorsque le langage employΘ est le C, la commande "debug" gΦre
  2228. l'Θvalustion de toutes les expressions correctes en C ANSI, α
  2229. l'exception de celles qui impliquent des extensions par macro, par
  2230. structure ou par ΘnumΘrations de dΘclarations de types. Un exemple de
  2231. dΘclaration de type, dans une expression est la suivante:
  2232.         ((struct { int i; char c; } *)p)->c = 'a';
  2233.  
  2234. Lorsque le langage employΘ est le C++, la commande debug accepte un
  2235. sous-ensemble des expressions du C++. Consultez la documentation du C++
  2236. pour plus de dΘtails.
  2237.  
  2238. Lorsque l'expression commenτe par un tiret (-) ou contient des
  2239. caractΦres ayant une signification spΘciale pour le dΘbogueur, elle
  2240. doit Ωtre entre parenthΦses, entre accolades ou entre crochets. Les
  2241. caractΦres ayant une signification spΘciale sont les suivants: >, >>,
  2242. |, ||, &&, #, les virgules, les points-virgules et les caractΦres de
  2243. retour chariot.
  2244.  
  2245. VOIR EGALEMENT
  2246. %db_lang, %lang, C++, if, print, scope, set, stop, expr_stop,
  2247. uservars, while
  2248. ++
  2249.  
  2250. ++ scope
  2251. NOM
  2252. scope - visibilitΘ d'un identificateur de programme.
  2253.  
  2254. DESCRIPTION Les commandes du dΘbogueur qui acceptent des emplacements
  2255. ou des expressions peuvent rΘfΘrencer les identificateurs dans les
  2256. programmes contr⌠lΘs, comme: les fonctions, les paramΩtres, les
  2257. variables, les labels, les types, les structures et les marques d'union,
  2258. les noms de membres et les ΘnumΘrations littΘrales. Les emplacements
  2259. peuvent Θgalement rΘfΘrencer des numΘros de ligne dans le code source.
  2260. La visibilitΘ d'un nom pour le dΘbogueur, α n'importe quel moment,
  2261. dΘpend de l'Θtat du programme α ce moment (contexte) et des informations
  2262. de dΘboguage fournies par le programme au dΘbogueur.
  2263.  
  2264. Les numΘros de lignes du code source, les noms des variables locales
  2265. d'une fonction particuliΦre, les noms des paramΩtres, les noms des types
  2266. les structures, les Θtiquettes d'union, les noms des membres et les
  2267. ΘnumΘrations littΘrales, ne sont disponibles que si le fichier dans
  2268. lequel ils sont rΘfΘrencΘs a ΘtΘ compilΘ en indiquant l'option -g au
  2269. compilateur. Les noms des fonctions et variables statiques ou globales
  2270. sont disponibles si le fichier qui les dΘfinit a ΘtΘ compilΘ avec
  2271. l'option -g ou si la table des symboles du programme n'a pas ΘtΘ
  2272. enlevΘe.
  2273.  
  2274. Les numΘros des lignes du code source, les fonctions et les variables
  2275. statiques ne sont visibles que lorsque le contexte actuel est prΘsent α
  2276. l'intΘrieur du fichier, c'est-α-dire si le programme a ΘtΘ arrΩtΘ α
  2277. l'intΘrieur du code gΘnΘrΘ a partir de ce fichier. Les paramΩtres de
  2278. fonction ne sont visibles que si le contexte actuel est contenu dans
  2279. cette fonction. Les variables locales ne sont visibles que lorsque le
  2280. contexte actuel est visible α l'intΘrieur du bloc qui les dΘfinit.
  2281.  
  2282. Les identificateurs qui ne sont pas visibles dans le contexte courant
  2283. peuvent souvent Ωtre accΘdΘs a des emplacements ou dans des expressions
  2284. en utilisant des noms qualifiΘs. Voir "expr" et "emplacement" pour une
  2285. syntaxe complΦte.
  2286.  
  2287. Les symboles dΘfinis dans des librairies partagΘes ne sont pas visibles,
  2288. jusqu'α ce que ces librairies soient chargΘes par l'Θditeur de liens
  2289. dynamique. Les symboles des librairies partagΘes chargΘs par des appels
  2290. a dlopen(3X) ne sont disponibles qu'aprΦs l'appel a dlopen.
  2291.  
  2292. VOIR EGALEMENT
  2293. %frame, %func, %line, expr, emplacement
  2294. ++
  2295.  
  2296. ++ whatis
  2297. NOM
  2298. whatis - affiche le type d'une expression.
  2299.  
  2300. RESUME
  2301. whatis [-p liste_proc] expr
  2302.  
  2303. DESCRIPTION
  2304. "whatis" affiche le type d'une expression dans le contexte courant
  2305. (%frame). Si une liste_proc est donnΘe, le type de l'expression est
  2306. ΘvaluΘe dans le contexte de chaque chemin d'exΘcution ou de chaque
  2307. processus dans la liste. L'expression "expr" peut Ωtre une expression
  2308. quelconque du langage actuel.
  2309.  
  2310. Si une variable est une structure ou un type de classe, "whatis
  2311. variable" affichera le nom de la structure ou de la classe. "whatis
  2312. structure_tag_name" ou "whatis type_name" affichera toutes les
  2313. informations concernant ce type, y compris les membres de la structure
  2314. et les constantes d'ΘnumΘration.
  2315.  
  2316. Si on lui donne en entrΘe un pointeur en direction d'une classe
  2317. d'objets possΘdant des fonctions virtuelles et que le dΘbogueur peut
  2318. dΘterminer que le type d'objet sur lequel on pointe est dΘrivΘ d'une
  2319. classe de base, whatis affichera a la fois la classe de base et la
  2320. classe dΘrivΘe.
  2321.  
  2322. EXEMPLES
  2323. whatis i
  2324. whatis main
  2325. whatis (i + 1) * 2.0
  2326. whatis struct foobar
  2327.  
  2328. VOIR EGALEMENT
  2329. %db_lang, C++, expr
  2330. ++
  2331.  
  2332. ++ programme
  2333. NOM
  2334. programme - un objet exΘcutable.
  2335.  
  2336. DESCRIPTION
  2337. Un program est un objet exΘcutable dans les des formats de fichier
  2338. objet compris par le dΘbogueur, avec les librairies partagΘes que
  2339. l'objet exΘcutable charge au moment de l'exΘcution. L'image exΘcutable
  2340. d'un programme est un processus. Puisqu'un processus peut se diviser,
  2341. plusieurs processus peuvent donc provenir d'un mΩme programme. Chacun
  2342. de ces processus peut Ωtre composΘ de plusieurs chemins d'exΘcution et
  2343. de contr⌠le. Faire rΘfΘrence a un programme par son nom ou faire
  2344. rΘfΘrence au programme actuel (%program), dans la liste de processus du
  2345. dΘbogueur, signifie tous les processus et les chemins d'exΘcution
  2346. dΘrivΘs de l'exΘcution initiale de ce programme.
  2347.  
  2348. VOIR EGALEMENT
  2349. %proc, %program, %thread, processus, liste_proc, thread
  2350. ++
  2351.  
  2352. ++ processus
  2353. NOM
  2354. processus - l'image exΘcutable d'un programme.
  2355.  
  2356. DESCRIPTION
  2357. Un process est l'image exΘcutable d'un programme et comprend un ou
  2358. plusieurs chemins d'exΘcution et de contr⌠le. Chaque chemin d'exΘcution
  2359. α l'intΘrieur d'un mΩme processus partage l'espace d'adressage commun du
  2360. processus, les identificateurs des parents et enfants du processus, les
  2361. privilΦges, les rΘpertoires racines et les rΘpertoires de travail, les
  2362. descriptions de fichiers et les verrous d'enregistrement, les limites
  2363. des ressources et le contexte de gestion des signaux (a l'exception du
  2364. signal de masquage et du signal de pile). Faire rΘfΘrence α un processus
  2365. en utilisant son identificateur de dΘboguage, son identificateur systΦme
  2366. ou en utilisant la variable %proc dans la liste des processus du
  2367. dΘbogueur revient α faire rΘfΘrence α tous les chemins d'exΘcution
  2368. compris dans le processus. Si un processus ne comprend qu'un seul chemin
  2369. d'exΘcution, ce processus sera comme un objet unique.
  2370.  
  2371. VOIR EGALEMENT
  2372. %follow, %proc, %program, %thread, liste_proc, program, thread
  2373. ++
  2374.  
  2375. ++ thread
  2376. NOM
  2377. thread - un unique chemin d'exΘcution et de contr⌠le.
  2378.  
  2379. DESCRIPTION
  2380. Un thread (chemin d'"exΘcution) est un seul contexte d'exΘcution
  2381. a l'intΘrieur d'un processus. Chaque chemin d'exΘcution possΦde
  2382. son popre ensemble de registres, son masque de signal et sa
  2383. propre pile de signaux. Un "thread", dans le contexte du
  2384. dΘbogueur, fait rΘfΘrence aux entitΘs de niveau utilisateur
  2385. implΘmentΘes dans les interfaces contenues dans <thread.h>. Ces
  2386. chemins d'exΘcution sont diffΘrents (et construits au-dessus) des
  2387. processus rΘduits (LWP - light-weight process) gΘrΘs par le
  2388. noyau. 
  2389.  
  2390. A un moment donnΘ, un chemin d'exΘcution peut Ωtre soit exΘcutΘ en mode
  2391. processus rΘduit (LWP), soit en attente. Un chemin d'exΘcution en
  2392. attente ne peut pas Ωtre lancΘ par le dΘbogueur, mais son Θtat peut
  2393. Ωtre examinΘ et modifΘ.
  2394.  
  2395. VOIR EGALEMENT
  2396. %proc, %program, %thread, processus, liste_proc, program,
  2397. ps, run, step
  2398. ++
  2399.  
  2400. ++ %thread
  2401. NOM
  2402. %thread - le chemin d'exΘcution actuel.
  2403.  
  2404. DESCRIPTION
  2405. Cette variable contient le nom du chemin d'exΘcution actuel. Il peut
  2406. Ωtre modifiΘ de maniΦre explicite en utilisant la commande "set" ou de
  2407. maniΦre implicite en utilisant les commandes "create", "grab" et
  2408. "release". La dΘfinition de %thread modifie Θgalement de maniΦre
  2409. implicite %proc, %program et %frame. Si le processus courant (%proc) ne
  2410. comporte qu'un seul chemin d'exΘcution, %thread ne contient qu'une
  2411. chaεne de caractΦres vide.
  2412.  
  2413. VOIR EGALEMENT
  2414. %frame, %proc, %program, processus, liste_proc, program, thread
  2415. ++
  2416.  
  2417. ++ %thread_change
  2418. NOM
  2419. %thread_change - contr⌠le le comportement des changements d'Θtat.
  2420.  
  2421. DESCRIPTION
  2422. Un chemin d'exΘcution peut passer par diffΘrents Θtats pendant sa durΘe
  2423. de vie: il est crΘΘ et on peut le quitter ; il peut Ωtre suspendu ou
  2424. continuΘ et un chemin d'exΘcution multiplexΘ peut abandonner son LWP ou
  2425. Ωtre adoptΘ par un LWP. %thread_change contr⌠le le comportement du
  2426. dΘbogueur lorsque l'un de ces changements d'Θtat a lieu. Les
  2427. valeurs correcte sont les suivantes:
  2428.         ignore   Le dΘbogueur n'imprimera pas de message annonτant
  2429.                  le changement ou l'arrΩt du chemin d'exΘcution
  2430.                  impliquΘ. Un chemin d'exΘcution nouvellement crΘΘ, un
  2431.                  chemin d'exΘcution continuΘ ou un chemin d'exΘcution
  2432.                  adoptΘ par un LWP sera lancΘ, le cas ΘchΘant.
  2433.         announce Le dΘbogueur imprimera un message annoncant le
  2434.                  changement d'Θtat, mais n'arrΩtera pas le chemin
  2435.                  d'exΘcution impliquΘ. Un chemin d'exΘcution
  2436.                  nouvellement crΘΘ, un chemin d'exΘcution continuΘ ou un
  2437.                  chemin d'exΘcution adoptΘ par un LWP sera lancΘ, le cas
  2438.                  ΘchΘant.
  2439.         stop     Le dΘbogueur imprimera un message annonτant le
  2440.                  changement d'Θtat et arrΩtera le chemin d'exΘcution
  2441.                  impliquΘ, le cas ΘchΘant. Un chemin d'exΘcution
  2442.                  continuΘ ou un chemin d'exΘcution adoptΘ par un LWP
  2443.                  sera arrΩtΘ (ou placΘ sur Off en cas d'Θtat LWP). En ce
  2444.                  qui concerne la crΘation de chemin d'exΘcution, le
  2445.                  chemin d'exΘcution qui procΦde α la crΘation du
  2446.                  nouveau chemin d'exΘcution sera arrΩtΘ et le nouveau
  2447.                  chemin d'exΘcution sera lui-mΩme arrΩtΘ une fois qu'il
  2448.                  atteindra la fonction indiquΘe dans l'appel
  2449.                  thr_create(3T).
  2450.  
  2451. La valeur par dΘfaut de %thread_change est "stop".
  2452.  
  2453. VOIR EGALEMENT
  2454. processus, programme, thread
  2455. ++
  2456.  
  2457. ++ C++
  2458. NOM
  2459. C++ - SpΘcificitΘ du langage C++
  2460.  
  2461. DESCRIPTION Le dΘbogueur va reconnaεtre un fichier objet compilΘ α
  2462. l'aide de la version 2.0 de C++ Compilation System ou du traducteur de
  2463. C++ cfront (version 2.1 ou 3.0) et va dΘfinir le langage actuel
  2464. (%db_lang) comme Θtant C++. Les noms s'affichent comme dans la source
  2465. C++ et non comme ils apparaissent dans le fichier objet.
  2466.  
  2467. Lorsque le langage actuel est C++, le dΘbogueur accepte un sous-ensemble
  2468. d'expressions faisant partie de C++, parmi lesquelles on trouve les
  2469. suivantes:
  2470.  
  2471.      o  Toutes les expressions acceptΘes lorsque C constitue le langage
  2472.         actuel,
  2473.      o  Appels adressΘs α des fonctions membre, dont font partie les
  2474.         fonctions membre virtuelles et les fonctions membre statiques,
  2475.      o  Appels adressΘs α des fonctions surchargΘes,
  2476.      o  Expressions utilisant des noms de types comme typedefs,
  2477.      o  Expressions utilisant des fonctions opΘrateur surchargΘes et
  2478.      o  Expressions accΘdant aux membres des classes grΓce au pointeur
  2479.         implicite "this", lorsque le processus ou le chemin d'exΘcution
  2480.         est arrΩtΘ dans une fonction associΘe aux membres des classes.
  2481.  
  2482. Les commandes print et set ont une option -v (verbose) qui permet
  2483. d'afficher des information dΘtaillΘes, comprenant les prototypes de
  2484. toutes les fonctions appelΘes par le dΘbogueur pour l'Θvaluation d'une
  2485. expression. Cette option est particuliΦrement utile pour une bonne
  2486. comprΘhension de ce qui peut se passer dans les expressions qui
  2487. utilisent des fonctions ou des opΘrateurs surchargΘs. Cette option -v
  2488. affiche Θgalement, pour la commande print, une structure et des membres
  2489. de classe gΘnΘrΘs par compilateur, tels que des pointeurs de tables de
  2490. fonctions virtuelles.
  2491.  
  2492. Lorsqu'il existe un pointeur d'objet de classe de base avec des
  2493. fonctions virtuelles et que le dΘbogueur peut dΘterminer que le type
  2494. d'objet vers lequel est dirigΘ le pointeur est une classe dΘrivΘe de la
  2495. classe de base, la commande whatis va afficher la classe de base et le
  2496. classe qui en dΘrive. La commande print va Θgalement afficher l'objet
  2497. comme d'un type dΘrivΘ.
  2498.  
  2499. Lors de l'impression d'une structure ou d'une classe, la commande print
  2500. va afficher les membres de classe static, en signalant qu'il s'agit de
  2501. membres statiques. Notez bien que les symboles de -v n'affichent pas ce
  2502. type de membres. Notez Θgalement que les membres de classe gΘnΘrΘs par
  2503. compilateur ne s'affichent qu'avec l'option -v de la commande print.
  2504.  
  2505. Les points d'interruption (ΘvΘnements stop) peuvent se dΘfinir avec:
  2506.  
  2507.      o  des fonctions membres de classe, comprenant les fonctions
  2508.         constructor, destructor et de conversion,
  2509.      o  des opΘrateurs surchargΘs et
  2510.      o  des fonctions surchargΘes qui utilisent le prototype complet ou
  2511.      o  des fonctions surchargΘes n'ayant pas d'information prototype.
  2512.         Dans ce cas, le dΘbogueur affiche une liste de fonctions et vous
  2513.         demande d'en sΘlectionner une ou la totalitΘ.
  2514.  
  2515. Un ΘvΘnement stop peut Θgalement Ωtre crΘe pour une combinaison
  2516. spΘcifique d'objet et de fonction membre en utilisant la syntaxe "stop
  2517. pointer->function" ou "stop object.function". Le dΘbogueur n'arrΩte le
  2518. processus ou le chemin d'exΘcution, au moment ou la fonction est entrΘe,
  2519. que si "ce" pointeur correspond α l'objet spΘcifiΘ. S'il s'agit d'une
  2520. fonction virtuelle, le dΘbogueur dΘfinit le point d'interruption sur la
  2521. fonction de remplacement appropriΘe.
  2522.  
  2523. EXEMPLES
  2524. print *this
  2525. print -v ptr->overloaded_f(1, 2)
  2526. whatis ptr_to_base stop C::f(int)
  2527. stop C::C
  2528. stop C::~C
  2529. stop C::operator int()
  2530. stop C::operator+
  2531. stop ptr->f(char *)
  2532.  
  2533. VOIR EGALEMENT
  2534. %db_lang, expr, print, set, stop, whatis
  2535. ++
  2536.