Pedagogical Group Provided Tutorials - Revision history

Mafero10: Commented out an internal link to a page that needs to be seriously cleaned up before it will be usable.

2013-10-09T22:08:51Z

Commented out an internal link to a page that needs to be seriously cleaned up before it will be usable.

← Older revision		Revision as of 22:08, 9 October 2013
Line 126:		Line 126:
	Display the history of function calls leading up to the current line.		Display the history of function calls leading up to the current line.

	[[Another GDB Short Tutorial:]]		<!-- The article linked here is an unreadable mess and we need to fix the formatting before it's worth linking. [[Another GDB Short Tutorial:]] -->

Mafero10: Updated Remote Connections link such that it actually leads to the remote connections page.

2013-10-09T22:06:40Z

Updated Remote Connections link such that it actually leads to the remote connections page.

← Older revision		Revision as of 22:06, 9 October 2013
Line 6:		Line 6:

	==Remote Connections From PC or Mac==		==Remote Connections From PC or Mac==
	A tutorial with a basic introduction to remote connecting from a PC or Mac can be found on the Earlham College CSWeb, here: [http://www.cs.earlham.edu/~psg/tutorials/~~index~~.html Remote Connections from PC or Mac]		A tutorial with a basic introduction to remote connecting from a PC or Mac can be found on the Earlham College CSWeb, here: [http://www.cs.earlham.edu/~psg/tutorials/remote_con_index.html Remote Connections from PC or Mac]

	==Short GDB Under Emacs Tutorial==		==Short GDB Under Emacs Tutorial==

Mafero10: Reorganized the page to make it more consistently readable; have not stripped out emacs tutorial yet, because it's not on our webspace yet.

2013-10-09T22:04:16Z

Reorganized the page to make it more consistently readable; have not stripped out emacs tutorial yet, because it's not on our webspace yet.

← Older revision		Revision as of 22:04, 9 October 2013
Line 1:		Line 1:
	=~~Tutorials That we provide~~:=		==VTWM and Emacs==
			A tutorial with a basic introduction to VTWM and emacs can be found on the Earlham College CSWeb, here: [http://www.cs.earlham.edu/~psg/tutorials/vtwm_emacs/index.html VTWM and Emacs]

	~~<br>[http~~:~~//www.cs.earlham.edu/~psg/tutorials/vtwm_emacs/index.html VTWM and Emacs]~~		==Linux==
	~~<br>~~[http://www.cs.earlham.edu/~psg/tutorials/linux/index.html Linux]		A tutorial with a basic introduction to linux can be found on the Earlham College CSWeb, here: [http://www.cs.earlham.edu/~psg/tutorials/linux/index.html Linux]
	~~<br>~~[http://www.cs.earlham.edu/~psg/tutorials/index.html Remote Connections from PC or Mac]
			==Remote Connections From PC or Mac==
			A tutorial with a basic introduction to remote connecting from a PC or Mac can be found on the Earlham College CSWeb, here: [http://www.cs.earlham.edu/~psg/tutorials/index.html Remote Connections from PC or Mac]

	==Short GDB Under Emacs Tutorial==		==Short GDB Under Emacs Tutorial==

Mmludin08 at 05:42, 22 February 2012

2012-02-22T05:42:33Z

← Older revision		Revision as of 05:42, 22 February 2012
Line 19:		Line 19:
	''To run GDB in Emacs'', first split your Emacs screen by typing `C-x 2' (C- stands for Control) and enter the window in which you want to run GDB by clicking in it with your left mouse button. Now type the command `M-x gdb' followed by `Return'. M- is read as Meta. On a Sun machine, Meta is the diamond next to the spacebar. On an SGI, it is the Alt key. M- is equivalent to ESC, except that you don't release Meta before pressing the next key, which makes it easier and faster than ESC.		''To run GDB in Emacs'', first split your Emacs screen by typing `C-x 2' (C- stands for Control) and enter the window in which you want to run GDB by clicking in it with your left mouse button. Now type the command `M-x gdb' followed by `Return'. M- is read as Meta. On a Sun machine, Meta is the diamond next to the spacebar. On an SGI, it is the Alt key. M- is equivalent to ESC, except that you don't release Meta before pressing the next key, which makes it easier and faster than ESC.

	The Emacs message bar will now display the message:		'''The Emacs message bar will now display the message:'''

	Run gdb (like this): gdb		Run gdb (like this): gdb
Line 29:		Line 29:
	The GDB window will display a message and then present you with the prompt (gdb). Whenever your cursor is on one of these prompts you can enter a GDB command. Pressing `Return' without entering a command will cause it to execute the previous command again. This is very convenient when stepping through a program line-by-line.		The GDB window will display a message and then present you with the prompt (gdb). Whenever your cursor is on one of these prompts you can enter a GDB command. Pressing `Return' without entering a command will cause it to execute the previous command again. This is very convenient when stepping through a program line-by-line.

	''All GDB commands can be abbreviated'' unless doing so renders them ambiguous. Most of the commonly used commands can be abbreviated to one character. The following command descriptions are in the form: command (abbreviation) arguments. Arguments listed in brackets are optional.		'''All GDB commands can be abbreviated''' unless doing so renders them ambiguous. Most of the commonly used commands can be abbreviated to one character. The following command descriptions are in the form: command (abbreviation) arguments. Arguments listed in brackets are optional.

	''help (h) [class][command]''		'''help (h) [class][command]'''

	With no arguments, this lists the command classes. If a class is specified, it will briefly describe commands in that class. If a command is specified, it will provide help on using that command.		With no arguments, this lists the command classes. If a class is specified, it will briefly describe commands in that class. If a command is specified, it will provide help on using that command.

	''quit (q)''		'''quit (q)'''

	Exit GDB. Type `C-x k' to kill the GDB buffer.		Exit GDB. Type `C-x k' to kill the GDB buffer.
Line 43:		Line 43:
	In order for GDB to be able to debug your program, you must compile the program with the `-g' option. Each time you recompile your program, you must reload it into GDB using the file command.		In order for GDB to be able to debug your program, you must compile the program with the `-g' option. Each time you recompile your program, you must reload it into GDB using the file command.

	''file file''		'''file file'''

	Load a new executable file.		Load a new executable file.
Line 51:		Line 51:
	If you start from within a directory different from the one containing your executable file, you will need to use this command to change to the proper directory.		If you start from within a directory different from the one containing your executable file, you will need to use this command to change to the proper directory.

	''run (r) [arglist]''		'''run (r) [arglist]'''

	This starts your program just as you would start it on the command line, except that `r' now replaces the name of your program. For example, if you normally run you program with `a.out 6 < inputfile > outputfile', you should run it under GDB with the command `r 6 < inputfile > outputfile'.		This starts your program just as you would start it on the command line, except that `r' now replaces the name of your program. For example, if you normally run you program with `a.out 6 < inputfile > outputfile', you should run it under GDB with the command `r 6 < inputfile > outputfile'.

	''C-c''		'''C-c'''

	If your program is running, typing C-c twice will interrupt it and give you a GDB prompt. The program is only paused at this point and can be resumed with continue or destroyed with kill.		If your program is running, typing C-c twice will interrupt it and give you a GDB prompt. The program is only paused at this point and can be resumed with continue or destroyed with kill.

	''kill (k)''		'''kill (k)'''

	Terminate the program.		Terminate the program.
Line 67:		Line 67:
	GDB will normally run your program until completion, until you type `C-c C-c' or until the program asks for some input. In order to tell GDB to pause while running your program, you must set a breakpoint. Once the program has stopped, various commands will tell it how to proceed. More advanced users may want to experiment with watchpoints, although in general they are tricky to use and cause your program to run very slowly.		GDB will normally run your program until completion, until you type `C-c C-c' or until the program asks for some input. In order to tell GDB to pause while running your program, you must set a breakpoint. Once the program has stopped, various commands will tell it how to proceed. More advanced users may want to experiment with watchpoints, although in general they are tricky to use and cause your program to run very slowly.

	''break (b) [function][line]''		'''break (b) [function][line]'''

	Set a breakpoint. If given a function name, GDB will break whenever that function is called. If given a line number, it will break whenever that line of your source code is reached.		Set a breakpoint. If given a function name, GDB will break whenever that function is called. If given a line number, it will break whenever that line of your source code is reached.

	''C-x space''		'''C-x space'''

	If you type this sequence while your cursor is in your source code, GDB will set a breakpoint at the line on which your cursor rests.		If you type this sequence while your cursor is in your source code, GDB will set a breakpoint at the line on which your cursor rests.

	''delete (d) n''		'''delete (d) n'''

	Delete the breakpoint or watchpoint whose number is specified by n.		Delete the breakpoint or watchpoint whose number is specified by n.

	''disable (dis) n''		'''disable (dis) n'''

	Temporarily disable the breakpoint or watchpoint whose number is specified by n.		Temporarily disable the breakpoint or watchpoint whose number is specified by n.

	''enable (ena) n''		'''enable (ena) n'''

	Undo the effects of disable.		Undo the effects of disable.

	''step (s)''		'''step (s)'''

	step executes the next line of code. If the next line contains a function call, step will enter that function.		step executes the next line of code. If the next line contains a function call, step will enter that function.

	''next (n)''		'''next (n)'''

	next is similar to step except that it will step over function calls.		next is similar to step except that it will step over function calls.

	''continue (c)''		'''continue (c)'''

	Resumes execution of the program until the next breakpoint is reached.		Resumes execution of the program until the next breakpoint is reached.

	''finish (fin)''		'''finish (fin)'''

	Continue until the current function has returned.		Continue until the current function has returned.

	''until (u) [function][line]''		'''until (u) [function][line]'''

	Continue until the program reaches a source line greater than the current one. It can also be given an argument similar to break and will continue until the specified line or function is reached. until will also break upon returning from the current function.		Continue until the program reaches a source line greater than the current one. It can also be given an argument similar to break and will continue until the specified line or function is reached. until will also break upon returning from the current function.
Line 109:		Line 109:
	===Getting Information===		===Getting Information===

	''print (p) expression''		'''print (p) expression'''

	This command performs several functions. It is most commonly used to print out the value of a variable. It can be given any C expression, including casts. For example, `p (int) A->array[5]' will display the sixth element of the array specified by A->array as an integer. print will try to display its output in a nice format. If given a structure, it will show each field and value. If given a pointer to an array of characters, it will display the entire string.		This command performs several functions. It is most commonly used to print out the value of a variable. It can be given any C expression, including casts. For example, `p (int) A->array[5]' will display the sixth element of the array specified by A->array as an integer. print will try to display its output in a nice format. If given a structure, it will show each field and value. If given a pointer to an array of characters, it will display the entire string.
Line 115:		Line 115:
	If an assignment or function call is given to print, it will perform the operation and display the result. For example `p a = 5' will set the value of the variable a to 5. If `p f(4, a)' is then performed, it will execute the function f with the arguments 4 and 5 and will display the value returned by f.		If an assignment or function call is given to print, it will perform the operation and display the result. For example `p a = 5' will set the value of the variable a to 5. If `p f(4, a)' is then performed, it will execute the function f with the arguments 4 and 5 and will display the value returned by f.

	''info (i) [b]''		'''info (i) [b]'''

	Without a type specified, info will display a list of all info subcommands. `info b' will list all of the breakpoints and watchpoints you have set.		Without a type specified, info will display a list of all info subcommands. `info b' will list all of the breakpoints and watchpoints you have set.

	''''backtrace (bt)''''		'''backtrace (bt)'''

	Display the history of function calls leading up to the current line.		Display the history of function calls leading up to the current line.

	[[Another GDB Short Tutorial:]]		[[Another GDB Short Tutorial:]]

Mmludin08 at 05:39, 22 February 2012

2012-02-22T05:39:58Z

← Older revision		Revision as of 05:39, 22 February 2012
Line 119:		Line 119:
	Without a type specified, info will display a list of all info subcommands. `info b' will list all of the breakpoints and watchpoints you have set.		Without a type specified, info will display a list of all info subcommands. `info b' will list all of the breakpoints and watchpoints you have set.

	''backtrace (bt)''		''''backtrace (bt)''''

	Display the history of function calls leading up to the current line.		Display the history of function calls leading up to the current line.

	[[Another GDB Short Tutorial:]]		[[Another GDB Short Tutorial:]]

Mmludin08 at 05:39, 22 February 2012

2012-02-22T05:39:14Z

← Older revision		Revision as of 05:39, 22 February 2012
Line 17:		Line 17:
	===Starting GDB under Emacs===		===Starting GDB under Emacs===

	To run GDB in Emacs, first split your Emacs screen by typing `C-x 2' (C- stands for Control) and enter the window in which you want to run GDB by clicking in it with your left mouse button. Now type the command `M-x gdb' followed by `Return'. M- is read as Meta. On a Sun machine, Meta is the diamond next to the spacebar. On an SGI, it is the Alt key. M- is equivalent to ESC, except that you don't release Meta before pressing the next key, which makes it easier and faster than ESC.		''To run GDB in Emacs'', first split your Emacs screen by typing `C-x 2' (C- stands for Control) and enter the window in which you want to run GDB by clicking in it with your left mouse button. Now type the command `M-x gdb' followed by `Return'. M- is read as Meta. On a Sun machine, Meta is the diamond next to the spacebar. On an SGI, it is the Alt key. M- is equivalent to ESC, except that you don't release Meta before pressing the next key, which makes it easier and faster than ESC.

	The Emacs message bar will now display the message:		The Emacs message bar will now display the message:
Line 29:		Line 29:
	The GDB window will display a message and then present you with the prompt (gdb). Whenever your cursor is on one of these prompts you can enter a GDB command. Pressing `Return' without entering a command will cause it to execute the previous command again. This is very convenient when stepping through a program line-by-line.		The GDB window will display a message and then present you with the prompt (gdb). Whenever your cursor is on one of these prompts you can enter a GDB command. Pressing `Return' without entering a command will cause it to execute the previous command again. This is very convenient when stepping through a program line-by-line.

	All GDB commands can be abbreviated unless doing so renders them ambiguous. Most of the commonly used commands can be abbreviated to one character. The following command descriptions are in the form: command (abbreviation) arguments. Arguments listed in brackets are optional.		''All GDB commands can be abbreviated'' unless doing so renders them ambiguous. Most of the commonly used commands can be abbreviated to one character. The following command descriptions are in the form: command (abbreviation) arguments. Arguments listed in brackets are optional.

	help (h) [class][command]		''help (h) [class][command]''

	With no arguments, this lists the command classes. If a class is specified, it will briefly describe commands in that class. If a command is specified, it will provide help on using that command.		With no arguments, this lists the command classes. If a class is specified, it will briefly describe commands in that class. If a command is specified, it will provide help on using that command.

	quit (q)		''quit (q)''

	Exit GDB. Type `C-x k' to kill the GDB buffer.		Exit GDB. Type `C-x k' to kill the GDB buffer.

	Loading and Running Programs		'''Loading and Running Programs'''

	In order for GDB to be able to debug your program, you must compile the program with the `-g' option. Each time you recompile your program, you must reload it into GDB using the file command.		In order for GDB to be able to debug your program, you must compile the program with the `-g' option. Each time you recompile your program, you must reload it into GDB using the file command.

	file file		''file file''

	Load a new executable file.		Load a new executable file.
Line 51:		Line 51:
	If you start from within a directory different from the one containing your executable file, you will need to use this command to change to the proper directory.		If you start from within a directory different from the one containing your executable file, you will need to use this command to change to the proper directory.

	run (r) [arglist]		''run (r) [arglist]''

	This starts your program just as you would start it on the command line, except that `r' now replaces the name of your program. For example, if you normally run you program with `a.out 6 < inputfile > outputfile', you should run it under GDB with the command `r 6 < inputfile > outputfile'.		This starts your program just as you would start it on the command line, except that `r' now replaces the name of your program. For example, if you normally run you program with `a.out 6 < inputfile > outputfile', you should run it under GDB with the command `r 6 < inputfile > outputfile'.

	C-c		''C-c''

	If your program is running, typing C-c twice will interrupt it and give you a GDB prompt. The program is only paused at this point and can be resumed with continue or destroyed with kill.		If your program is running, typing C-c twice will interrupt it and give you a GDB prompt. The program is only paused at this point and can be resumed with continue or destroyed with kill.

	kill (k)		''kill (k)''

	Terminate the program.		Terminate the program.

	Moving Through the Program		'''Moving Through the Program'''

	GDB will normally run your program until completion, until you type `C-c C-c' or until the program asks for some input. In order to tell GDB to pause while running your program, you must set a breakpoint. Once the program has stopped, various commands will tell it how to proceed. More advanced users may want to experiment with watchpoints, although in general they are tricky to use and cause your program to run very slowly.		GDB will normally run your program until completion, until you type `C-c C-c' or until the program asks for some input. In order to tell GDB to pause while running your program, you must set a breakpoint. Once the program has stopped, various commands will tell it how to proceed. More advanced users may want to experiment with watchpoints, although in general they are tricky to use and cause your program to run very slowly.

	break (b) [function][line]		''break (b) [function][line]''

	Set a breakpoint. If given a function name, GDB will break whenever that function is called. If given a line number, it will break whenever that line of your source code is reached.		Set a breakpoint. If given a function name, GDB will break whenever that function is called. If given a line number, it will break whenever that line of your source code is reached.

	C-x space		''C-x space''

	If you type this sequence while your cursor is in your source code, GDB will set a breakpoint at the line on which your cursor rests.		If you type this sequence while your cursor is in your source code, GDB will set a breakpoint at the line on which your cursor rests.

	delete (d) n		''delete (d) n''

	Delete the breakpoint or watchpoint whose number is specified by n.		Delete the breakpoint or watchpoint whose number is specified by n.

	disable (dis) n		''disable (dis) n''

	Temporarily disable the breakpoint or watchpoint whose number is specified by n.		Temporarily disable the breakpoint or watchpoint whose number is specified by n.

	enable (ena) n		''enable (ena) n''

	Undo the effects of disable.		Undo the effects of disable.

	step (s)		''step (s)''

	step executes the next line of code. If the next line contains a function call, step will enter that function.		step executes the next line of code. If the next line contains a function call, step will enter that function.

	next (n)		''next (n)''

	next is similar to step except that it will step over function calls.		next is similar to step except that it will step over function calls.

	continue (c)		''continue (c)''

	Resumes execution of the program until the next breakpoint is reached.		Resumes execution of the program until the next breakpoint is reached.

	finish (fin)		''finish (fin)''

	Continue until the current function has returned.		Continue until the current function has returned.

	until (u) [function][line]		''until (u) [function][line]''

	Continue until the program reaches a source line greater than the current one. It can also be given an argument similar to break and will continue until the specified line or function is reached. until will also break upon returning from the current function.		Continue until the program reaches a source line greater than the current one. It can also be given an argument similar to break and will continue until the specified line or function is reached. until will also break upon returning from the current function.
Line 109:		Line 109:
	===Getting Information===		===Getting Information===

	print (p) expression		''print (p) expression''

	This command performs several functions. It is most commonly used to print out the value of a variable. It can be given any C expression, including casts. For example, `p (int) A->array[5]' will display the sixth element of the array specified by A->array as an integer. print will try to display its output in a nice format. If given a structure, it will show each field and value. If given a pointer to an array of characters, it will display the entire string.		This command performs several functions. It is most commonly used to print out the value of a variable. It can be given any C expression, including casts. For example, `p (int) A->array[5]' will display the sixth element of the array specified by A->array as an integer. print will try to display its output in a nice format. If given a structure, it will show each field and value. If given a pointer to an array of characters, it will display the entire string.
Line 115:		Line 115:
	If an assignment or function call is given to print, it will perform the operation and display the result. For example `p a = 5' will set the value of the variable a to 5. If `p f(4, a)' is then performed, it will execute the function f with the arguments 4 and 5 and will display the value returned by f.		If an assignment or function call is given to print, it will perform the operation and display the result. For example `p a = 5' will set the value of the variable a to 5. If `p f(4, a)' is then performed, it will execute the function f with the arguments 4 and 5 and will display the value returned by f.

	info (i) [b]		''info (i) [b]''

	Without a type specified, info will display a list of all info subcommands. `info b' will list all of the breakpoints and watchpoints you have set.		Without a type specified, info will display a list of all info subcommands. `info b' will list all of the breakpoints and watchpoints you have set.

	backtrace (bt)		''backtrace (bt)''

	Display the history of function calls leading up to the current line.		Display the history of function calls leading up to the current line.

	[[Another GDB Short Tutorial:]]		[[Another GDB Short Tutorial:]]

Mmludin08 at 05:24, 22 February 2012

2012-02-22T05:24:18Z

← Older revision		Revision as of 05:24, 22 February 2012
Line 122:		Line 122:

	Display the history of function calls leading up to the current line.		Display the history of function calls leading up to the current line.

			[[Another GDB Short Tutorial:]]

Mmludin08 at 04:56, 22 February 2012

2012-02-22T04:56:18Z

← Older revision		Revision as of 04:56, 22 February 2012
Line 7:		Line 7:
	==Short GDB Under Emacs Tutorial==		==Short GDB Under Emacs Tutorial==
	===The GNU debugger: is a complete Documentation of debugging with GDB===		===The GNU debugger: is a complete Documentation of debugging with GDB===
	[http://sourceware.org/gdb/download/onlinedocs/gdb/index.html/ html Copy or Debugging with GDB]		[http://sourceware.org/gdb/download/onlinedocs/gdb/index.html html Copy or Debugging with GDB]

	===GDB in Short - What is GDB?===		===GDB in Short - What is GDB?===

Mmludin08 at 04:52, 22 February 2012

2012-02-22T04:52:02Z

← Older revision		Revision as of 04:52, 22 February 2012
Line 7:		Line 7:
	==Short GDB Under Emacs Tutorial==		==Short GDB Under Emacs Tutorial==
	===The GNU debugger: is a complete Documentation of debugging with GDB===		===The GNU debugger: is a complete Documentation of debugging with GDB===
	~~<br>~~[http://sourceware.org/gdb/download/onlinedocs/gdb/index.html/ html Copy or Debugging with GDB]		[http://sourceware.org/gdb/download/onlinedocs/gdb/index.html/ html Copy or Debugging with GDB]

	===GDB in Short - What is GDB?===		===GDB in Short - What is GDB?===

Mmludin08 at 04:51, 22 February 2012

2012-02-22T04:51:31Z

← Older revision		Revision as of 04:51, 22 February 2012
Line 6:		Line 6:

	==Short GDB Under Emacs Tutorial==		==Short GDB Under Emacs Tutorial==

	===The GNU debugger: is a complete Documentation of debugging with GDB===		===The GNU debugger: is a complete Documentation of debugging with GDB===

	<br>[http://sourceware.org/gdb/download/onlinedocs/gdb/index.html/ html Copy or Debugging with GDB]		<br>[http://sourceware.org/gdb/download/onlinedocs/gdb/index.html/ html Copy or Debugging with GDB]