blob: 6509e71ab298fe64fd855f2f7322cc173977f5b4 (plain)

ofs	hex dump	ascii
0000	d1 f2 0d 0a cc e7 4c 4d 63 00 00 00 00 00 00 00 00 10 00 00 00 40 00 00 00 73 cd 01 00 00 64 00	......LMc............@...s....d.
0020	00 5a 00 00 64 01 00 64 02 00 6b 01 00 5a 01 00 65 01 00 69 02 00 64 03 00 6a 02 00 5a 03 00 64	.Z..d..d..k..Z..e..i..d..j..Z..d
0040	01 00 64 02 00 6b 04 00 5a 04 00 64 01 00 64 02 00 6b 05 00 5a 05 00 64 01 00 64 02 00 6b 06 00	..d..k..Z..d..d..k..Z..d..d..k..
0060	5a 06 00 64 01 00 64 02 00 6b 07 00 5a 07 00 64 01 00 64 02 00 6b 08 00 5a 08 00 64 04 00 65 09	Z..d..d..k..Z..d..d..k..Z..d..e.
0080	00 66 01 00 64 05 00 84 00 00 83 00 00 59 5a 0a 00 65 03 00 6f 4c 00 01 64 01 00 64 02 00 6b 0b	.f..d........YZ..e..oL..d..d..k.
00a0	00 5a 0b 00 64 01 00 64 02 00 6b 0c 00 5a 0c 00 64 01 00 64 06 00 6b 0d 00 54 64 07 00 66 00 00	.Z..d..d..k..Z..d..d..k..Td..f..
00c0	64 08 00 84 00 00 83 00 00 59 5a 0e 00 64 09 00 66 00 00 64 0a 00 84 00 00 83 00 00 59 5a 0f 00	d........YZ..d..f..d........YZ..
00e0	6e 31 00 01 64 01 00 64 02 00 6b 10 00 5a 10 00 64 01 00 64 02 00 6b 11 00 5a 11 00 64 01 00 64	n1..d..d..k..Z..d..d..k..Z..d..d
0100	02 00 6b 12 00 5a 12 00 64 01 00 64 02 00 6b 13 00 5a 13 00 64 0b 00 64 0c 00 64 0d 00 64 0e 00	..k..Z..d..d..k..Z..d..d..d..d..
0120	64 0f 00 64 04 00 67 06 00 5a 14 00 79 13 00 65 04 00 69 15 00 64 10 00 83 01 00 5a 16 00 57 6e	d..d..g..Z..y..e..i..d.....Z..Wn
0140	0d 00 01 01 01 64 11 00 5a 16 00 6e 01 00 58 67 00 00 5a 17 00 64 12 00 84 00 00 5a 18 00 64 01	.....d..Z..n..Xg..Z..d.....Z..d.
0160	00 5a 19 00 64 13 00 5a 1a 00 64 14 00 84 00 00 5a 1b 00 64 15 00 84 00 00 5a 1c 00 64 16 00 84	.Z..d..Z..d.....Z..d.....Z..d...
0180	00 00 5a 1d 00 64 17 00 84 00 00 5a 1e 00 64 0b 00 65 1f 00 66 01 00 64 18 00 84 00 00 83 00 00	..Z..d.....Z..d..e..f..d........
01a0	59 5a 20 00 64 19 00 84 00 00 5a 21 00 64 1a 00 84 00 00 5a 22 00 64 1b 00 6f 0a 00 01 65 23 00	YZ..d.....Z!.d.....Z".d..o...e#.
01c0	64 1c 00 6a 02 00 6f 1d 00 01 65 03 00 6f 0b 00 01 65 22 00 83 00 00 01 6e 08 00 01 65 21 00 83	d..j..o...e..o...e".....n...e!..
01e0	00 00 01 6e 01 00 01 64 02 00 53 28 1d 00 00 00 73 35 2b 00 00 73 75 62 70 72 6f 63 65 73 73 20	...n...d..S(....s5+..subprocess.
0200	2d 20 53 75 62 70 72 6f 63 65 73 73 65 73 20 77 69 74 68 20 61 63 63 65 73 73 69 62 6c 65 20 49	-.Subprocesses.with.accessible.I
0220	2f 4f 20 73 74 72 65 61 6d 73 0a 0a 54 68 69 73 20 6d 6f 64 75 6c 65 20 61 6c 6c 6f 77 73 20 79	/O.streams..This.module.allows.y
0240	6f 75 20 74 6f 20 73 70 61 77 6e 20 70 72 6f 63 65 73 73 65 73 2c 20 63 6f 6e 6e 65 63 74 20 74	ou.to.spawn.processes,.connect.t
0260	6f 20 74 68 65 69 72 0a 69 6e 70 75 74 2f 6f 75 74 70 75 74 2f 65 72 72 6f 72 20 70 69 70 65 73	o.their.input/output/error.pipes
0280	2c 20 61 6e 64 20 6f 62 74 61 69 6e 20 74 68 65 69 72 20 72 65 74 75 72 6e 20 63 6f 64 65 73 2e	,.and.obtain.their.return.codes.
02a0	20 20 54 68 69 73 20 6d 6f 64 75 6c 65 0a 69 6e 74 65 6e 64 73 20 74 6f 20 72 65 70 6c 61 63 65	..This.module.intends.to.replace
02c0	20 73 65 76 65 72 61 6c 20 6f 74 68 65 72 2c 20 6f 6c 64 65 72 20 6d 6f 64 75 6c 65 73 20 61 6e	.several.other,.older.modules.an
02e0	64 20 66 75 6e 63 74 69 6f 6e 73 2c 20 6c 69 6b 65 3a 0a 0a 6f 73 2e 73 79 73 74 65 6d 0a 6f 73	d.functions,.like:..os.system.os
0300	2e 73 70 61 77 6e 2a 0a 6f 73 2e 70 6f 70 65 6e 2a 0a 70 6f 70 65 6e 32 2e 2a 0a 63 6f 6d 6d 61	.spawn*.os.popen*.popen2.*.comma
0320	6e 64 73 2e 2a 0a 0a 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 68 6f 77 20 74 68 65	nds.*..Information.about.how.the
0340	20 73 75 62 70 72 6f 63 65 73 73 20 6d 6f 64 75 6c 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74	.subprocess.module.can.be.used.t
0360	6f 20 72 65 70 6c 61 63 65 20 74 68 65 73 65 0a 6d 6f 64 75 6c 65 73 20 61 6e 64 20 66 75 6e 63	o.replace.these.modules.and.func
0380	74 69 6f 6e 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 62 65 6c 6f 77 2e 0a 0a 0a 0a 55 73 69	tions.can.be.found.below.....Usi
03a0	6e 67 20 74 68 65 20 73 75 62 70 72 6f 63 65 73 73 20 6d 6f 64 75 6c 65 0a 3d 3d 3d 3d 3d 3d 3d	ng.the.subprocess.module.=======
03c0	3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 54 68 69 73 20 6d 6f 64 75 6c 65	====================.This.module
03e0	20 64 65 66 69 6e 65 73 20 6f 6e 65 20 63 6c 61 73 73 20 63 61 6c 6c 65 64 20 50 6f 70 65 6e 3a	.defines.one.class.called.Popen:
0400	0a 0a 63 6c 61 73 73 20 50 6f 70 65 6e 28 61 72 67 73 2c 20 62 75 66 73 69 7a 65 3d 30 2c 20 65	..class.Popen(args,.bufsize=0,.e
0420	78 65 63 75 74 61 62 6c 65 3d 4e 6f 6e 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 74 64 69	xecutable=None,.............stdi
0440	6e 3d 4e 6f 6e 65 2c 20 73 74 64 6f 75 74 3d 4e 6f 6e 65 2c 20 73 74 64 65 72 72 3d 4e 6f 6e 65	n=None,.stdout=None,.stderr=None
0460	2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 72 65 65 78 65 63 5f 66 6e 3d 4e 6f 6e 65 2c 20 63	,.............preexec_fn=None,.c
0480	6c 6f 73 65 5f 66 64 73 3d 46 61 6c 73 65 2c 20 73 68 65 6c 6c 3d 46 61 6c 73 65 2c 0a 20 20 20	lose_fds=False,.shell=False,....
04a0	20 20 20 20 20 20 20 20 20 63 77 64 3d 4e 6f 6e 65 2c 20 65 6e 76 3d 4e 6f 6e 65 2c 20 75 6e 69	.........cwd=None,.env=None,.uni
04c0	76 65 72 73 61 6c 5f 6e 65 77 6c 69 6e 65 73 3d 46 61 6c 73 65 2c 0a 20 20 20 20 20 20 20 20 20	versal_newlines=False,..........
04e0	20 20 20 73 74 61 72 74 75 70 69 6e 66 6f 3d 4e 6f 6e 65 2c 20 63 72 65 61 74 69 6f 6e 66 6c 61	...startupinfo=None,.creationfla
0500	67 73 3d 30 29 3a 0a 0a 0a 41 72 67 75 6d 65 6e 74 73 20 61 72 65 3a 0a 0a 61 72 67 73 20 73 68	gs=0):...Arguments.are:..args.sh
0520	6f 75 6c 64 20 62 65 20 61 20 73 74 72 69 6e 67 2c 20 6f 72 20 61 20 73 65 71 75 65 6e 63 65 20	ould.be.a.string,.or.a.sequence.
0540	6f 66 20 70 72 6f 67 72 61 6d 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 0a 70 72 6f 67 72	of.program.arguments...The.progr
0560	61 6d 20 74 6f 20 65 78 65 63 75 74 65 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 74 68 65 20 66 69	am.to.execute.is.normally.the.fi
0580	72 73 74 20 69 74 65 6d 20 69 6e 20 74 68 65 20 61 72 67 73 20 73 65 71 75 65 6e 63 65 20 6f 72	rst.item.in.the.args.sequence.or
05a0	0a 73 74 72 69 6e 67 2c 20 62 75 74 20 63 61 6e 20 62 65 20 65 78 70 6c 69 63 69 74 6c 79 20 73	.string,.but.can.be.explicitly.s
05c0	65 74 20 62 79 20 75 73 69 6e 67 20 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 61 72 67 75 6d	et.by.using.the.executable.argum
05e0	65 6e 74 2e 0a 0a 4f 6e 20 55 4e 49 58 2c 20 77 69 74 68 20 73 68 65 6c 6c 3d 46 61 6c 73 65 20	ent...On.UNIX,.with.shell=False.
0600	28 64 65 66 61 75 6c 74 29 3a 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 74 68 65 20 50 6f 70	(default):.In.this.case,.the.Pop
0620	65 6e 20 63 6c 61 73 73 0a 75 73 65 73 20 6f 73 2e 65 78 65 63 76 70 28 29 20 74 6f 20 65 78 65	en.class.uses.os.execvp().to.exe
0640	63 75 74 65 20 74 68 65 20 63 68 69 6c 64 20 70 72 6f 67 72 61 6d 2e 20 20 61 72 67 73 20 73 68	cute.the.child.program...args.sh
0660	6f 75 6c 64 20 6e 6f 72 6d 61 6c 6c 79 0a 62 65 20 61 20 73 65 71 75 65 6e 63 65 2e 20 20 41 20	ould.normally.be.a.sequence...A.
0680	73 74 72 69 6e 67 20 77 69 6c 6c 20 62 65 20 74 72 65 61 74 65 64 20 61 73 20 61 20 73 65 71 75	string.will.be.treated.as.a.sequ
06a0	65 6e 63 65 20 77 69 74 68 20 74 68 65 20 73 74 72 69 6e 67 0a 61 73 20 74 68 65 20 6f 6e 6c 79	ence.with.the.string.as.the.only
06c0	20 69 74 65 6d 20 28 74 68 65 20 70 72 6f 67 72 61 6d 20 74 6f 20 65 78 65 63 75 74 65 29 2e 0a	.item.(the.program.to.execute)..
06e0	0a 4f 6e 20 55 4e 49 58 2c 20 77 69 74 68 20 73 68 65 6c 6c 3d 54 72 75 65 3a 20 49 66 20 61 72	.On.UNIX,.with.shell=True:.If.ar
0700	67 73 20 69 73 20 61 20 73 74 72 69 6e 67 2c 20 69 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65	gs.is.a.string,.it.specifies.the
0720	0a 63 6f 6d 6d 61 6e 64 20 73 74 72 69 6e 67 20 74 6f 20 65 78 65 63 75 74 65 20 74 68 72 6f 75	.command.string.to.execute.throu
0740	67 68 20 74 68 65 20 73 68 65 6c 6c 2e 20 20 49 66 20 61 72 67 73 20 69 73 20 61 20 73 65 71 75	gh.the.shell...If.args.is.a.sequ
0760	65 6e 63 65 2c 0a 74 68 65 20 66 69 72 73 74 20 69 74 65 6d 20 73 70 65 63 69 66 69 65 73 20 74	ence,.the.first.item.specifies.t
0780	68 65 20 63 6f 6d 6d 61 6e 64 20 73 74 72 69 6e 67 2c 20 61 6e 64 20 61 6e 79 20 61 64 64 69 74	he.command.string,.and.any.addit
07a0	69 6f 6e 61 6c 20 69 74 65 6d 73 0a 77 69 6c 6c 20 62 65 20 74 72 65 61 74 65 64 20 61 73 20 61	ional.items.will.be.treated.as.a
07c0	64 64 69 74 69 6f 6e 61 6c 20 73 68 65 6c 6c 20 61 72 67 75 6d 65 6e 74 73 2e 0a 0a 4f 6e 20 57	dditional.shell.arguments...On.W
07e0	69 6e 64 6f 77 73 3a 20 74 68 65 20 50 6f 70 65 6e 20 63 6c 61 73 73 20 75 73 65 73 20 43 72 65	indows:.the.Popen.class.uses.Cre
0800	61 74 65 50 72 6f 63 65 73 73 28 29 20 74 6f 20 65 78 65 63 75 74 65 20 74 68 65 20 63 68 69 6c	ateProcess().to.execute.the.chil
0820	64 0a 70 72 6f 67 72 61 6d 2c 20 77 68 69 63 68 20 6f 70 65 72 61 74 65 73 20 6f 6e 20 73 74 72	d.program,.which.operates.on.str
0840	69 6e 67 73 2e 20 20 49 66 20 61 72 67 73 20 69 73 20 61 20 73 65 71 75 65 6e 63 65 2c 20 69 74	ings...If.args.is.a.sequence,.it
0860	20 77 69 6c 6c 20 62 65 0a 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 61 20 73 74 72 69 6e 67 20 75	.will.be.converted.to.a.string.u
0880	73 69 6e 67 20 74 68 65 20 6c 69 73 74 32 63 6d 64 6c 69 6e 65 20 6d 65 74 68 6f 64 2e 20 20 50	sing.the.list2cmdline.method...P
08a0	6c 65 61 73 65 20 6e 6f 74 65 20 74 68 61 74 0a 6e 6f 74 20 61 6c 6c 20 4d 53 20 57 69 6e 64 6f	lease.note.that.not.all.MS.Windo
08c0	77 73 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 69 6e 74 65 72 70 72 65 74 20 74 68 65 20 63 6f	ws.applications.interpret.the.co
08e0	6d 6d 61 6e 64 20 6c 69 6e 65 20 74 68 65 20 73 61 6d 65 0a 77 61 79 3a 20 54 68 65 20 6c 69 73	mmand.line.the.same.way:.The.lis
0900	74 32 63 6d 64 6c 69 6e 65 20 69 73 20 64 65 73 69 67 6e 65 64 20 66 6f 72 20 61 70 70 6c 69 63	t2cmdline.is.designed.for.applic
0920	61 74 69 6f 6e 73 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 0a 72 75 6c 65 73 20 61 73 20 74	ations.using.the.same.rules.as.t
0940	68 65 20 4d 53 20 43 20 72 75 6e 74 69 6d 65 2e 0a 0a 62 75 66 73 69 7a 65 2c 20 69 66 20 67 69	he.MS.C.runtime...bufsize,.if.gi
0960	76 65 6e 2c 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 6d 65 61 6e 69 6e 67 20 61 73 20 74 68 65	ven,.has.the.same.meaning.as.the
0980	20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 61 72 67 75 6d 65 6e 74 0a 74 6f 20 74 68 65 20 62	.corresponding.argument.to.the.b
09a0	75 69 6c 74 2d 69 6e 20 6f 70 65 6e 28 29 20 66 75 6e 63 74 69 6f 6e 3a 20 30 20 6d 65 61 6e 73	uilt-in.open().function:.0.means
09c0	20 75 6e 62 75 66 66 65 72 65 64 2c 20 31 20 6d 65 61 6e 73 20 6c 69 6e 65 0a 62 75 66 66 65 72	.unbuffered,.1.means.line.buffer
09e0	65 64 2c 20 61 6e 79 20 6f 74 68 65 72 20 70 6f 73 69 74 69 76 65 20 76 61 6c 75 65 20 6d 65 61	ed,.any.other.positive.value.mea
0a00	6e 73 20 75 73 65 20 61 20 62 75 66 66 65 72 20 6f 66 0a 28 61 70 70 72 6f 78 69 6d 61 74 65 6c	ns.use.a.buffer.of.(approximatel
0a20	79 29 20 74 68 61 74 20 73 69 7a 65 2e 20 20 41 20 6e 65 67 61 74 69 76 65 20 62 75 66 73 69 7a	y).that.size...A.negative.bufsiz
0a40	65 20 6d 65 61 6e 73 20 74 6f 20 75 73 65 20 74 68 65 20 73 79 73 74 65 6d 0a 64 65 66 61 75 6c	e.means.to.use.the.system.defaul
0a60	74 2c 20 77 68 69 63 68 20 75 73 75 61 6c 6c 79 20 6d 65 61 6e 73 20 66 75 6c 6c 79 20 62 75 66	t,.which.usually.means.fully.buf
0a80	66 65 72 65 64 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 0a 62 75	fered...The.default.value.for.bu
0aa0	66 73 69 7a 65 20 69 73 20 30 20 28 75 6e 62 75 66 66 65 72 65 64 29 2e 0a 0a 73 74 64 69 6e 2c	fsize.is.0.(unbuffered)...stdin,
0ac0	20 73 74 64 6f 75 74 20 61 6e 64 20 73 74 64 65 72 72 20 73 70 65 63 69 66 79 20 74 68 65 20 65	.stdout.and.stderr.specify.the.e
0ae0	78 65 63 75 74 65 64 20 70 72 6f 67 72 61 6d 73 27 20 73 74 61 6e 64 61 72 64 0a 69 6e 70 75 74	xecuted.programs'.standard.input
0b00	2c 20 73 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74 20 61 6e 64 20 73 74 61 6e 64 61 72 64 20 65	,.standard.output.and.standard.e
0b20	72 72 6f 72 20 66 69 6c 65 20 68 61 6e 64 6c 65 73 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e	rror.file.handles,.respectively.
0b40	0a 56 61 6c 69 64 20 76 61 6c 75 65 73 20 61 72 65 20 50 49 50 45 2c 20 61 6e 20 65 78 69 73 74	.Valid.values.are.PIPE,.an.exist
0b60	69 6e 67 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 28 61 20 70 6f 73 69 74 69 76 65 0a	ing.file.descriptor.(a.positive.
0b80	69 6e 74 65 67 65 72 29 2c 20 61 6e 20 65 78 69 73 74 69 6e 67 20 66 69 6c 65 20 6f 62 6a 65 63	integer),.an.existing.file.objec
0ba0	74 2c 20 61 6e 64 20 4e 6f 6e 65 2e 20 20 50 49 50 45 20 69 6e 64 69 63 61 74 65 73 20 74 68 61	t,.and.None...PIPE.indicates.tha
0bc0	74 20 61 0a 6e 65 77 20 70 69 70 65 20 74 6f 20 74 68 65 20 63 68 69 6c 64 20 73 68 6f 75 6c 64	t.a.new.pipe.to.the.child.should
0be0	20 62 65 20 63 72 65 61 74 65 64 2e 20 20 57 69 74 68 20 4e 6f 6e 65 2c 20 6e 6f 20 72 65 64 69	.be.created...With.None,.no.redi
0c00	72 65 63 74 69 6f 6e 0a 77 69 6c 6c 20 6f 63 63 75 72 3b 20 74 68 65 20 63 68 69 6c 64 27 73 20	rection.will.occur;.the.child's.
0c20	66 69 6c 65 20 68 61 6e 64 6c 65 73 20 77 69 6c 6c 20 62 65 20 69 6e 68 65 72 69 74 65 64 20 66	file.handles.will.be.inherited.f
0c40	72 6f 6d 20 74 68 65 0a 70 61 72 65 6e 74 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 73	rom.the.parent...Additionally,.s
0c60	74 64 65 72 72 20 63 61 6e 20 62 65 20 53 54 44 4f 55 54 2c 20 77 68 69 63 68 20 69 6e 64 69 63	tderr.can.be.STDOUT,.which.indic
0c80	61 74 65 73 20 74 68 61 74 20 74 68 65 0a 73 74 64 65 72 72 20 64 61 74 61 20 66 72 6f 6d 20 74	ates.that.the.stderr.data.from.t
0ca0	68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64 20 62 65 20 63 61 70 74 75 72	he.applications.should.be.captur
0cc0	65 64 20 69 6e 74 6f 20 74 68 65 20 73 61 6d 65 0a 66 69 6c 65 20 68 61 6e 64 6c 65 20 61 73 20	ed.into.the.same.file.handle.as.
0ce0	66 6f 72 20 73 74 64 6f 75 74 2e 0a 0a 49 66 20 70 72 65 65 78 65 63 5f 66 6e 20 69 73 20 73 65	for.stdout...If.preexec_fn.is.se
0d00	74 20 74 6f 20 61 20 63 61 6c 6c 61 62 6c 65 20 6f 62 6a 65 63 74 2c 20 74 68 69 73 20 6f 62 6a	t.to.a.callable.object,.this.obj
0d20	65 63 74 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 0a 69 6e 20 74 68 65 20 63 68 69 6c 64 20	ect.will.be.called.in.the.child.
0d40	70 72 6f 63 65 73 73 20 6a 75 73 74 20 62 65 66 6f 72 65 20 74 68 65 20 63 68 69 6c 64 20 69 73	process.just.before.the.child.is
0d60	20 65 78 65 63 75 74 65 64 2e 0a 0a 49 66 20 63 6c 6f 73 65 5f 66 64 73 20 69 73 20 74 72 75 65	.executed...If.close_fds.is.true
0d80	2c 20 61 6c 6c 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 20 65 78 63 65 70 74 20 30 2c	,.all.file.descriptors.except.0,
0da0	20 31 20 61 6e 64 20 32 20 77 69 6c 6c 20 62 65 0a 63 6c 6f 73 65 64 20 62 65 66 6f 72 65 20 74	.1.and.2.will.be.closed.before.t
0dc0	68 65 20 63 68 69 6c 64 20 70 72 6f 63 65 73 73 20 69 73 20 65 78 65 63 75 74 65 64 2e 0a 0a 69	he.child.process.is.executed...i
0de0	66 20 73 68 65 6c 6c 20 69 73 20 74 72 75 65 2c 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 63	f.shell.is.true,.the.specified.c
0e00	6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 62 65 20 65 78 65 63 75 74 65 64 20 74 68 72 6f 75 67 68 20	ommand.will.be.executed.through.
0e20	74 68 65 0a 73 68 65 6c 6c 2e 0a 0a 49 66 20 63 77 64 20 69 73 20 6e 6f 74 20 4e 6f 6e 65 2c 20	the.shell...If.cwd.is.not.None,.
0e40	74 68 65 20 63 75 72 72 65 6e 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 63 68	the.current.directory.will.be.ch
0e60	61 6e 67 65 64 20 74 6f 20 63 77 64 0a 62 65 66 6f 72 65 20 74 68 65 20 63 68 69 6c 64 20 69 73	anged.to.cwd.before.the.child.is
0e80	20 65 78 65 63 75 74 65 64 2e 0a 0a 49 66 20 65 6e 76 20 69 73 20 6e 6f 74 20 4e 6f 6e 65 2c 20	.executed...If.env.is.not.None,.
0ea0	69 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61	it.defines.the.environment.varia
0ec0	62 6c 65 73 20 66 6f 72 20 74 68 65 20 6e 65 77 0a 70 72 6f 63 65 73 73 2e 0a 0a 49 66 20 75 6e	bles.for.the.new.process...If.un
0ee0	69 76 65 72 73 61 6c 5f 6e 65 77 6c 69 6e 65 73 20 69 73 20 74 72 75 65 2c 20 74 68 65 20 66 69	iversal_newlines.is.true,.the.fi
0f00	6c 65 20 6f 62 6a 65 63 74 73 20 73 74 64 6f 75 74 20 61 6e 64 20 73 74 64 65 72 72 20 61 72 65	le.objects.stdout.and.stderr.are
0f20	0a 6f 70 65 6e 65 64 20 61 73 20 61 20 74 65 78 74 20 66 69 6c 65 73 2c 20 62 75 74 20 6c 69 6e	.opened.as.a.text.files,.but.lin
0f40	65 73 20 6d 61 79 20 62 65 20 74 65 72 6d 69 6e 61 74 65 64 20 62 79 20 61 6e 79 20 6f 66 20 27	es.may.be.terminated.by.any.of.'
0f60	5c 6e 27 2c 0a 74 68 65 20 55 6e 69 78 20 65 6e 64 2d 6f 66 2d 6c 69 6e 65 20 63 6f 6e 76 65 6e	\n',.the.Unix.end-of-line.conven
0f80	74 69 6f 6e 2c 20 27 5c 72 27 2c 20 74 68 65 20 4d 61 63 69 6e 74 6f 73 68 20 63 6f 6e 76 65 6e	tion,.'\r',.the.Macintosh.conven
0fa0	74 69 6f 6e 20 6f 72 0a 27 5c 72 5c 6e 27 2c 20 74 68 65 20 57 69 6e 64 6f 77 73 20 63 6f 6e 76	tion.or.'\r\n',.the.Windows.conv
0fc0	65 6e 74 69 6f 6e 2e 20 20 41 6c 6c 20 6f 66 20 74 68 65 73 65 20 65 78 74 65 72 6e 61 6c 20 72	ention...All.of.these.external.r
0fe0	65 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 0a 61 72 65 20 73 65 65 6e 20 61 73 20 27 5c 6e 27 20	epresentations.are.seen.as.'\n'.
1000	62 79 20 74 68 65 20 50 79 74 68 6f 6e 20 70 72 6f 67 72 61 6d 2e 20 20 4e 6f 74 65 3a 20 54 68	by.the.Python.program...Note:.Th
1020	69 73 20 66 65 61 74 75 72 65 20 69 73 20 6f 6e 6c 79 0a 61 76 61 69 6c 61 62 6c 65 20 69 66 20	is.feature.is.only.available.if.
1040	50 79 74 68 6f 6e 20 69 73 20 62 75 69 6c 74 20 77 69 74 68 20 75 6e 69 76 65 72 73 61 6c 20 6e	Python.is.built.with.universal.n
1060	65 77 6c 69 6e 65 20 73 75 70 70 6f 72 74 20 28 74 68 65 0a 64 65 66 61 75 6c 74 29 2e 20 20 41	ewline.support.(the.default)...A
1080	6c 73 6f 2c 20 74 68 65 20 6e 65 77 6c 69 6e 65 73 20 61 74 74 72 69 62 75 74 65 20 6f 66 20 74	lso,.the.newlines.attribute.of.t
10a0	68 65 20 66 69 6c 65 20 6f 62 6a 65 63 74 73 20 73 74 64 6f 75 74 2c 0a 73 74 64 69 6e 20 61 6e	he.file.objects.stdout,.stdin.an
10c0	64 20 73 74 64 65 72 72 20 61 72 65 20 6e 6f 74 20 75 70 64 61 74 65 64 20 62 79 20 74 68 65 20	d.stderr.are.not.updated.by.the.
10e0	63 6f 6d 6d 75 6e 69 63 61 74 65 28 29 20 6d 65 74 68 6f 64 2e 0a 0a 54 68 65 20 73 74 61 72 74	communicate().method...The.start
1100	75 70 69 6e 66 6f 20 61 6e 64 20 63 72 65 61 74 69 6f 6e 66 6c 61 67 73 2c 20 69 66 20 67 69 76	upinfo.and.creationflags,.if.giv
1120	65 6e 2c 20 77 69 6c 6c 20 62 65 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 0a 75 6e 64 65 72 6c	en,.will.be.passed.to.the.underl
1140	79 69 6e 67 20 43 72 65 61 74 65 50 72 6f 63 65 73 73 28 29 20 66 75 6e 63 74 69 6f 6e 2e 20 20	ying.CreateProcess().function...
1160	54 68 65 79 20 63 61 6e 20 73 70 65 63 69 66 79 20 74 68 69 6e 67 73 20 73 75 63 68 20 61 73 0a	They.can.specify.things.such.as.
1180	61 70 70 65 61 72 61 6e 63 65 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 77 69 6e 64 6f 77 20 61 6e	appearance.of.the.main.window.an
11a0	64 20 70 72 69 6f 72 69 74 79 20 66 6f 72 20 74 68 65 20 6e 65 77 20 70 72 6f 63 65 73 73 2e 0a	d.priority.for.the.new.process..
11c0	28 57 69 6e 64 6f 77 73 20 6f 6e 6c 79 29 0a 0a 0a 54 68 69 73 20 6d 6f 64 75 6c 65 20 61 6c 73	(Windows.only)...This.module.als
11e0	6f 20 64 65 66 69 6e 65 73 20 74 77 6f 20 73 68 6f 72 74 63 75 74 20 66 75 6e 63 74 69 6f 6e 73	o.defines.two.shortcut.functions
1200	3a 0a 0a 63 61 6c 6c 28 2a 70 6f 70 65 6e 61 72 67 73 2c 20 2a 2a 6b 77 61 72 67 73 29 3a 0a 20	:..call(*popenargs,.**kwargs):..
1220	20 20 20 52 75 6e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 72 67 75 6d 65 6e 74 73 2e 20 20	...Run.command.with.arguments...
1240	57 61 69 74 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 6f 6d 70 6c 65 74 65 2c 20 74 68	Wait.for.command.to.complete,.th
1260	65 6e 0a 20 20 20 20 72 65 74 75 72 6e 20 74 68 65 20 72 65 74 75 72 6e 63 6f 64 65 20 61 74 74	en.....return.the.returncode.att
1280	72 69 62 75 74 65 2e 0a 0a 20 20 20 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 74	ribute.......The.arguments.are.t
12a0	68 65 20 73 61 6d 65 20 61 73 20 66 6f 72 20 74 68 65 20 50 6f 70 65 6e 20 63 6f 6e 73 74 72 75	he.same.as.for.the.Popen.constru
12c0	63 74 6f 72 2e 20 20 45 78 61 6d 70 6c 65 3a 0a 0a 20 20 20 20 72 65 74 63 6f 64 65 20 3d 20 63	ctor...Example:......retcode.=.c
12e0	61 6c 6c 28 5b 22 6c 73 22 2c 20 22 2d 6c 22 5d 29 0a 0a 63 68 65 63 6b 5f 63 61 6c 6c 28 2a 70	all(["ls",."-l"])..check_call(*p
1300	6f 70 65 6e 61 72 67 73 2c 20 2a 2a 6b 77 61 72 67 73 29 3a 0a 20 20 20 20 52 75 6e 20 63 6f 6d	openargs,.**kwargs):.....Run.com
1320	6d 61 6e 64 20 77 69 74 68 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 57 61 69 74 20 66 6f 72 20 63	mand.with.arguments...Wait.for.c
1340	6f 6d 6d 61 6e 64 20 74 6f 20 63 6f 6d 70 6c 65 74 65 2e 20 20 49 66 20 74 68 65 0a 20 20 20 20	ommand.to.complete...If.the.....
1360	65 78 69 74 20 63 6f 64 65 20 77 61 73 20 7a 65 72 6f 20 74 68 65 6e 20 72 65 74 75 72 6e 2c 20	exit.code.was.zero.then.return,.
1380	6f 74 68 65 72 77 69 73 65 20 72 61 69 73 65 0a 20 20 20 20 43 61 6c 6c 65 64 50 72 6f 63 65 73	otherwise.raise.....CalledProces
13a0	73 45 72 72 6f 72 2e 20 20 54 68 65 20 43 61 6c 6c 65 64 50 72 6f 63 65 73 73 45 72 72 6f 72 20	sError...The.CalledProcessError.
13c0	6f 62 6a 65 63 74 20 77 69 6c 6c 20 68 61 76 65 20 74 68 65 0a 20 20 20 20 72 65 74 75 72 6e 20	object.will.have.the.....return.
13e0	63 6f 64 65 20 69 6e 20 74 68 65 20 72 65 74 75 72 6e 63 6f 64 65 20 61 74 74 72 69 62 75 74 65	code.in.the.returncode.attribute
1400	2e 0a 0a 20 20 20 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 74 68 65 20 73 61 6d	.......The.arguments.are.the.sam
1420	65 20 61 73 20 66 6f 72 20 74 68 65 20 50 6f 70 65 6e 20 63 6f 6e 73 74 72 75 63 74 6f 72 2e 20	e.as.for.the.Popen.constructor..
1440	20 45 78 61 6d 70 6c 65 3a 0a 0a 20 20 20 20 63 68 65 63 6b 5f 63 61 6c 6c 28 5b 22 6c 73 22 2c	.Example:......check_call(["ls",
1460	20 22 2d 6c 22 5d 29 0a 0a 45 78 63 65 70 74 69 6f 6e 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 45	."-l"])..Exceptions.----------.E
1480	78 63 65 70 74 69 6f 6e 73 20 72 61 69 73 65 64 20 69 6e 20 74 68 65 20 63 68 69 6c 64 20 70 72	xceptions.raised.in.the.child.pr
14a0	6f 63 65 73 73 2c 20 62 65 66 6f 72 65 20 74 68 65 20 6e 65 77 20 70 72 6f 67 72 61 6d 20 68 61	ocess,.before.the.new.program.ha
14c0	73 0a 73 74 61 72 74 65 64 20 74 6f 20 65 78 65 63 75 74 65 2c 20 77 69 6c 6c 20 62 65 20 72 65	s.started.to.execute,.will.be.re
14e0	2d 72 61 69 73 65 64 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74 2e 20 20 41 64 64 69 74 69 6f 6e	-raised.in.the.parent...Addition
1500	61 6c 6c 79 2c 0a 74 68 65 20 65 78 63 65 70 74 69 6f 6e 20 6f 62 6a 65 63 74 20 77 69 6c 6c 20	ally,.the.exception.object.will.
1520	68 61 76 65 20 6f 6e 65 20 65 78 74 72 61 20 61 74 74 72 69 62 75 74 65 20 63 61 6c 6c 65 64 0a	have.one.extra.attribute.called.
1540	27 63 68 69 6c 64 5f 74 72 61 63 65 62 61 63 6b 27 2c 20 77 68 69 63 68 20 69 73 20 61 20 73 74	'child_traceback',.which.is.a.st
1560	72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 72 61 63 65 62 61 63 6b 20 69 6e 66 6f 72 6d	ring.containing.traceback.inform
1580	61 74 69 6f 6e 0a 66 72 6f 6d 20 74 68 65 20 63 68 69 6c 64 73 20 70 6f 69 6e 74 20 6f 66 20 76	ation.from.the.childs.point.of.v
15a0	69 65 77 2e 0a 0a 54 68 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 65 78 63 65 70 74 69 6f 6e 20	iew...The.most.common.exception.
15c0	72 61 69 73 65 64 20 69 73 20 4f 53 45 72 72 6f 72 2e 20 20 54 68 69 73 20 6f 63 63 75 72 73 2c	raised.is.OSError...This.occurs,
15e0	20 66 6f 72 0a 65 78 61 6d 70 6c 65 2c 20 77 68 65 6e 20 74 72 79 69 6e 67 20 74 6f 20 65 78 65	.for.example,.when.trying.to.exe
1600	63 75 74 65 20 61 20 6e 6f 6e 2d 65 78 69 73 74 65 6e 74 20 66 69 6c 65 2e 20 20 41 70 70 6c 69	cute.a.non-existent.file...Appli
1620	63 61 74 69 6f 6e 73 0a 73 68 6f 75 6c 64 20 70 72 65 70 61 72 65 20 66 6f 72 20 4f 53 45 72 72	cations.should.prepare.for.OSErr
1640	6f 72 73 2e 0a 0a 41 20 56 61 6c 75 65 45 72 72 6f 72 20 77 69 6c 6c 20 62 65 20 72 61 69 73 65	ors...A.ValueError.will.be.raise
1660	64 20 69 66 20 50 6f 70 65 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 69 6e 76 61 6c 69	d.if.Popen.is.called.with.invali
1680	64 20 61 72 67 75 6d 65 6e 74 73 2e 0a 0a 63 68 65 63 6b 5f 63 61 6c 6c 28 29 20 77 69 6c 6c 20	d.arguments...check_call().will.
16a0	72 61 69 73 65 20 43 61 6c 6c 65 64 50 72 6f 63 65 73 73 45 72 72 6f 72 2c 20 69 66 20 74 68 65	raise.CalledProcessError,.if.the
16c0	20 63 61 6c 6c 65 64 20 70 72 6f 63 65 73 73 0a 72 65 74 75 72 6e 73 20 61 20 6e 6f 6e 2d 7a 65	.called.process.returns.a.non-ze
16e0	72 6f 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0a 0a 0a 53 65 63 75 72 69 74 79 0a 2d 2d 2d 2d 2d	ro.return.code....Security.-----
1700	2d 2d 2d 0a 55 6e 6c 69 6b 65 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 6f 70 65 6e 20 66 75 6e 63	---.Unlike.some.other.popen.func
1720	74 69 6f 6e 73 2c 20 74 68 69 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 69 6c 6c 20	tions,.this.implementation.will.
1740	6e 65 76 65 72 20 63 61 6c 6c 0a 2f 62 69 6e 2f 73 68 20 69 6d 70 6c 69 63 69 74 6c 79 2e 20 20	never.call./bin/sh.implicitly...
1760	54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 61 6c 6c 20 63 68 61 72 61 63 74 65 72 73 2c 20	This.means.that.all.characters,.
1780	69 6e 63 6c 75 64 69 6e 67 20 73 68 65 6c 6c 0a 6d 65 74 61 63 68 61 72 61 63 74 65 72 73 2c 20	including.shell.metacharacters,.
17a0	63 61 6e 20 73 61 66 65 6c 79 20 62 65 20 70 61 73 73 65 64 20 74 6f 20 63 68 69 6c 64 20 70 72	can.safely.be.passed.to.child.pr
17c0	6f 63 65 73 73 65 73 2e 0a 0a 0a 50 6f 70 65 6e 20 6f 62 6a 65 63 74 73 0a 3d 3d 3d 3d 3d 3d 3d	ocesses....Popen.objects.=======
17e0	3d 3d 3d 3d 3d 3d 0a 49 6e 73 74 61 6e 63 65 73 20 6f 66 20 74 68 65 20 50 6f 70 65 6e 20 63 6c	======.Instances.of.the.Popen.cl
1800	61 73 73 20 68 61 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 65 74 68 6f 64 73 3a 0a	ass.have.the.following.methods:.
1820	0a 70 6f 6c 6c 28 29 0a 20 20 20 20 43 68 65 63 6b 20 69 66 20 63 68 69 6c 64 20 70 72 6f 63 65	.poll().....Check.if.child.proce
1840	73 73 20 68 61 73 20 74 65 72 6d 69 6e 61 74 65 64 2e 20 20 52 65 74 75 72 6e 73 20 72 65 74 75	ss.has.terminated...Returns.retu
1860	72 6e 63 6f 64 65 0a 20 20 20 20 61 74 74 72 69 62 75 74 65 2e 0a 0a 77 61 69 74 28 29 0a 20 20	rncode.....attribute...wait()...
1880	20 20 57 61 69 74 20 66 6f 72 20 63 68 69 6c 64 20 70 72 6f 63 65 73 73 20 74 6f 20 74 65 72 6d	..Wait.for.child.process.to.term
18a0	69 6e 61 74 65 2e 20 20 52 65 74 75 72 6e 73 20 72 65 74 75 72 6e 63 6f 64 65 20 61 74 74 72 69	inate...Returns.returncode.attri
18c0	62 75 74 65 2e 0a 0a 63 6f 6d 6d 75 6e 69 63 61 74 65 28 69 6e 70 75 74 3d 4e 6f 6e 65 29 0a 20	bute...communicate(input=None)..
18e0	20 20 20 49 6e 74 65 72 61 63 74 20 77 69 74 68 20 70 72 6f 63 65 73 73 3a 20 53 65 6e 64 20 64	...Interact.with.process:.Send.d
1900	61 74 61 20 74 6f 20 73 74 64 69 6e 2e 20 20 52 65 61 64 20 64 61 74 61 20 66 72 6f 6d 20 73 74	ata.to.stdin...Read.data.from.st
1920	64 6f 75 74 0a 20 20 20 20 61 6e 64 20 73 74 64 65 72 72 2c 20 75 6e 74 69 6c 20 65 6e 64 2d 6f	dout.....and.stderr,.until.end-o
1940	66 2d 66 69 6c 65 20 69 73 20 72 65 61 63 68 65 64 2e 20 20 57 61 69 74 20 66 6f 72 20 70 72 6f	f-file.is.reached...Wait.for.pro
1960	63 65 73 73 20 74 6f 0a 20 20 20 20 74 65 72 6d 69 6e 61 74 65 2e 20 20 54 68 65 20 6f 70 74 69	cess.to.....terminate...The.opti
1980	6f 6e 61 6c 20 69 6e 70 75 74 20 61 72 67 75 6d 65 6e 74 20 73 68 6f 75 6c 64 20 62 65 20 61 20	onal.input.argument.should.be.a.
19a0	73 74 72 69 6e 67 20 74 6f 20 62 65 0a 20 20 20 20 73 65 6e 74 20 74 6f 20 74 68 65 20 63 68 69	string.to.be.....sent.to.the.chi
19c0	6c 64 20 70 72 6f 63 65 73 73 2c 20 6f 72 20 4e 6f 6e 65 2c 20 69 66 20 6e 6f 20 64 61 74 61 20	ld.process,.or.None,.if.no.data.
19e0	73 68 6f 75 6c 64 20 62 65 20 73 65 6e 74 20 74 6f 0a 20 20 20 20 74 68 65 20 63 68 69 6c 64 2e	should.be.sent.to.....the.child.
1a00	0a 0a 20 20 20 20 63 6f 6d 6d 75 6e 69 63 61 74 65 28 29 20 72 65 74 75 72 6e 73 20 61 20 74 75	......communicate().returns.a.tu
1a20	70 6c 65 20 28 73 74 64 6f 75 74 2c 20 73 74 64 65 72 72 29 2e 0a 0a 20 20 20 20 4e 6f 74 65 3a	ple.(stdout,.stderr).......Note:
1a40	20 54 68 65 20 64 61 74 61 20 72 65 61 64 20 69 73 20 62 75 66 66 65 72 65 64 20 69 6e 20 6d 65	.The.data.read.is.buffered.in.me
1a60	6d 6f 72 79 2c 20 73 6f 20 64 6f 20 6e 6f 74 20 75 73 65 20 74 68 69 73 0a 20 20 20 20 6d 65 74	mory,.so.do.not.use.this.....met
1a80	68 6f 64 20 69 66 20 74 68 65 20 64 61 74 61 20 73 69 7a 65 20 69 73 20 6c 61 72 67 65 20 6f 72	hod.if.the.data.size.is.large.or
1aa0	20 75 6e 6c 69 6d 69 74 65 64 2e 0a 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 74 74 72 69	.unlimited...The.following.attri
1ac0	62 75 74 65 73 20 61 72 65 20 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 3a 0a 0a 73 74 64 69 6e	butes.are.also.available:..stdin
1ae0	0a 20 20 20 20 49 66 20 74 68 65 20 73 74 64 69 6e 20 61 72 67 75 6d 65 6e 74 20 69 73 20 50 49	.....If.the.stdin.argument.is.PI
1b00	50 45 2c 20 74 68 69 73 20 61 74 74 72 69 62 75 74 65 20 69 73 20 61 20 66 69 6c 65 20 6f 62 6a	PE,.this.attribute.is.a.file.obj
1b20	65 63 74 0a 20 20 20 20 74 68 61 74 20 70 72 6f 76 69 64 65 73 20 69 6e 70 75 74 20 74 6f 20 74	ect.....that.provides.input.to.t
1b40	68 65 20 63 68 69 6c 64 20 70 72 6f 63 65 73 73 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74	he.child.process...Otherwise,.it
1b60	20 69 73 20 4e 6f 6e 65 2e 0a 0a 73 74 64 6f 75 74 0a 20 20 20 20 49 66 20 74 68 65 20 73 74 64	.is.None...stdout.....If.the.std
1b80	6f 75 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 50 49 50 45 2c 20 74 68 69 73 20 61 74 74 72 69	out.argument.is.PIPE,.this.attri
1ba0	62 75 74 65 20 69 73 20 61 20 66 69 6c 65 20 6f 62 6a 65 63 74 0a 20 20 20 20 74 68 61 74 20 70	bute.is.a.file.object.....that.p
1bc0	72 6f 76 69 64 65 73 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 63 68 69 6c 64 20 70 72	rovides.output.from.the.child.pr
1be0	6f 63 65 73 73 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 69 73 0a 20 20 20 20 4e 6f 6e	ocess...Otherwise,.it.is.....Non
1c00	65 2e 0a 0a 73 74 64 65 72 72 0a 20 20 20 20 49 66 20 74 68 65 20 73 74 64 65 72 72 20 61 72 67	e...stderr.....If.the.stderr.arg
1c20	75 6d 65 6e 74 20 69 73 20 50 49 50 45 2c 20 74 68 69 73 20 61 74 74 72 69 62 75 74 65 20 69 73	ument.is.PIPE,.this.attribute.is
1c40	20 66 69 6c 65 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 20 20 20 20 70 72 6f 76 69 64 65 73 20 65	.file.object.that.....provides.e
1c60	72 72 6f 72 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 63 68 69 6c 64 20 70 72 6f 63 65	rror.output.from.the.child.proce
1c80	73 73 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 69 73 0a 20 20 20 20 4e 6f 6e 65 2e 0a	ss...Otherwise,.it.is.....None..
1ca0	0a 70 69 64 0a 20 20 20 20 54 68 65 20 70 72 6f 63 65 73 73 20 49 44 20 6f 66 20 74 68 65 20 63	.pid.....The.process.ID.of.the.c
1cc0	68 69 6c 64 20 70 72 6f 63 65 73 73 2e 0a 0a 72 65 74 75 72 6e 63 6f 64 65 0a 20 20 20 20 54 68	hild.process...returncode.....Th
1ce0	65 20 63 68 69 6c 64 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 20 20 41 20 4e 6f 6e 65 20 76 61 6c	e.child.return.code...A.None.val
1d00	75 65 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65 20 70 72 6f 63 65 73 73 0a 20 20	ue.indicates.that.the.process...
1d20	20 20 68 61 73 6e 27 74 20 74 65 72 6d 69 6e 61 74 65 64 20 79 65 74 2e 20 20 41 20 6e 65 67 61	..hasn't.terminated.yet...A.nega
1d40	74 69 76 65 20 76 61 6c 75 65 20 2d 4e 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65	tive.value.-N.indicates.that.the
1d60	0a 20 20 20 20 63 68 69 6c 64 20 77 61 73 20 74 65 72 6d 69 6e 61 74 65 64 20 62 79 20 73 69 67	.....child.was.terminated.by.sig
1d80	6e 61 6c 20 4e 20 28 55 4e 49 58 20 6f 6e 6c 79 29 2e 0a 0a 0a 52 65 70 6c 61 63 69 6e 67 20 6f	nal.N.(UNIX.only)....Replacing.o
1da0	6c 64 65 72 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 74 68 20 74 68 65 20 73 75 62 70 72 6f 63 65	lder.functions.with.the.subproce
1dc0	73 73 20 6d 6f 64 75 6c 65 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d	ss.module.======================
1de0	3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 49	==============================.I
1e00	6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e 2c 20 22 61 20 3d 3d 3e 20 62 22 20 6d 65 61 6e 73 20	n.this.section,."a.==>.b".means.
1e20	74 68 61 74 20 62 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73 20 61 20 72 65 70 6c 61 63 65 6d	that.b.can.be.used.as.a.replacem
1e40	65 6e 74 0a 66 6f 72 20 61 2e 0a 0a 4e 6f 74 65 3a 20 41 6c 6c 20 66 75 6e 63 74 69 6f 6e 73 20	ent.for.a...Note:.All.functions.
1e60	69 6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 66 61 69 6c 20 28 6d 6f 72 65 20 6f 72 20 6c 65	in.this.section.fail.(more.or.le
1e80	73 73 29 20 73 69 6c 65 6e 74 6c 79 20 69 66 0a 74 68 65 20 65 78 65 63 75 74 65 64 20 70 72 6f	ss).silently.if.the.executed.pro
1ea0	67 72 61 6d 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 3b 20 74 68 69 73 20 6d 6f 64 75 6c	gram.cannot.be.found;.this.modul
1ec0	65 20 72 61 69 73 65 73 20 61 6e 20 4f 53 45 72 72 6f 72 0a 65 78 63 65 70 74 69 6f 6e 2e 0a 0a	e.raises.an.OSError.exception...
1ee0	49 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 73 2c 20 77 65 20 61 73	In.the.following.examples,.we.as
1f00	73 75 6d 65 20 74 68 61 74 20 74 68 65 20 73 75 62 70 72 6f 63 65 73 73 20 6d 6f 64 75 6c 65 20	sume.that.the.subprocess.module.
1f20	69 73 0a 69 6d 70 6f 72 74 65 64 20 77 69 74 68 20 22 66 72 6f 6d 20 73 75 62 70 72 6f 63 65 73	is.imported.with."from.subproces
1f40	73 20 69 6d 70 6f 72 74 20 2a 22 2e 0a 0a 0a 52 65 70 6c 61 63 69 6e 67 20 2f 62 69 6e 2f 73 68	s.import.*"....Replacing./bin/sh
1f60	20 73 68 65 6c 6c 20 62 61 63 6b 71 75 6f 74 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d	.shell.backquote.---------------
1f80	2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 6f 75 74 70 75 74 3d 60 6d 79 63 6d 64	------------------.output=`mycmd
1fa0	20 6d 79 61 72 67 60 0a 3d 3d 3e 0a 6f 75 74 70 75 74 20 3d 20 50 6f 70 65 6e 28 5b 22 6d 79 63	.myarg`.==>.output.=.Popen(["myc
1fc0	6d 64 22 2c 20 22 6d 79 61 72 67 22 5d 2c 20 73 74 64 6f 75 74 3d 50 49 50 45 29 2e 63 6f 6d 6d	md",."myarg"],.stdout=PIPE).comm
1fe0	75 6e 69 63 61 74 65 28 29 5b 30 5d 0a 0a 0a 52 65 70 6c 61 63 69 6e 67 20 73 68 65 6c 6c 20 70	unicate()[0]...Replacing.shell.p
2000	69 70 65 20 6c 69 6e 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d	ipe.line.-----------------------
2020	2d 2d 0a 6f 75 74 70 75 74 3d 60 64 6d 65 73 67 20 7c 20 67 72 65 70 20 68 64 61 60 0a 3d 3d 3e	--.output=`dmesg.|.grep.hda`.==>
2040	0a 70 31 20 3d 20 50 6f 70 65 6e 28 5b 22 64 6d 65 73 67 22 5d 2c 20 73 74 64 6f 75 74 3d 50 49	.p1.=.Popen(["dmesg"],.stdout=PI
2060	50 45 29 0a 70 32 20 3d 20 50 6f 70 65 6e 28 5b 22 67 72 65 70 22 2c 20 22 68 64 61 22 5d 2c 20	PE).p2.=.Popen(["grep",."hda"],.
2080	73 74 64 69 6e 3d 70 31 2e 73 74 64 6f 75 74 2c 20 73 74 64 6f 75 74 3d 50 49 50 45 29 0a 6f 75	stdin=p1.stdout,.stdout=PIPE).ou
20a0	74 70 75 74 20 3d 20 70 32 2e 63 6f 6d 6d 75 6e 69 63 61 74 65 28 29 5b 30 5d 0a 0a 0a 52 65 70	tput.=.p2.communicate()[0]...Rep
20c0	6c 61 63 69 6e 67 20 6f 73 2e 73 79 73 74 65 6d 28 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d	lacing.os.system().-------------
20e0	2d 2d 2d 2d 2d 2d 2d 2d 0a 73 74 73 20 3d 20 6f 73 2e 73 79 73 74 65 6d 28 22 6d 79 63 6d 64 22	--------.sts.=.os.system("mycmd"
2100	20 2b 20 22 20 6d 79 61 72 67 22 29 0a 3d 3d 3e 0a 70 20 3d 20 50 6f 70 65 6e 28 22 6d 79 63 6d	.+.".myarg").==>.p.=.Popen("mycm
2120	64 22 20 2b 20 22 20 6d 79 61 72 67 22 2c 20 73 68 65 6c 6c 3d 54 72 75 65 29 0a 70 69 64 2c 20	d".+.".myarg",.shell=True).pid,.
2140	73 74 73 20 3d 20 6f 73 2e 77 61 69 74 70 69 64 28 70 2e 70 69 64 2c 20 30 29 0a 0a 4e 6f 74 65	sts.=.os.waitpid(p.pid,.0)..Note
2160	3a 0a 0a 2a 20 43 61 6c 6c 69 6e 67 20 74 68 65 20 70 72 6f 67 72 61 6d 20 74 68 72 6f 75 67 68	:..*.Calling.the.program.through
2180	20 74 68 65 20 73 68 65 6c 6c 20 69 73 20 75 73 75 61 6c 6c 79 20 6e 6f 74 20 72 65 71 75 69 72	.the.shell.is.usually.not.requir
21a0	65 64 2e 0a 0a 2a 20 49 74 27 73 20 65 61 73 69 65 72 20 74 6f 20 6c 6f 6f 6b 20 61 74 20 74 68	ed...*.It's.easier.to.look.at.th
21c0	65 20 72 65 74 75 72 6e 63 6f 64 65 20 61 74 74 72 69 62 75 74 65 20 74 68 61 6e 20 74 68 65 0a	e.returncode.attribute.than.the.
21e0	20 20 65 78 69 74 73 74 61 74 75 73 2e 0a 0a 41 20 6d 6f 72 65 20 72 65 61 6c 2d 77 6f 72 6c 64	..exitstatus...A.more.real-world
2200	20 65 78 61 6d 70 6c 65 20 77 6f 75 6c 64 20 6c 6f 6f 6b 20 6c 69 6b 65 20 74 68 69 73 3a 0a 0a	.example.would.look.like.this:..
2220	74 72 79 3a 0a 20 20 20 20 72 65 74 63 6f 64 65 20 3d 20 63 61 6c 6c 28 22 6d 79 63 6d 64 22 20	try:.....retcode.=.call("mycmd".
2240	2b 20 22 20 6d 79 61 72 67 22 2c 20 73 68 65 6c 6c 3d 54 72 75 65 29 0a 20 20 20 20 69 66 20 72	+.".myarg",.shell=True).....if.r
2260	65 74 63 6f 64 65 20 3c 20 30 3a 0a 20 20 20 20 20 20 20 20 70 72 69 6e 74 20 3e 3e 73 79 73 2e	etcode.<.0:.........print.>>sys.
2280	73 74 64 65 72 72 2c 20 22 43 68 69 6c 64 20 77 61 73 20 74 65 72 6d 69 6e 61 74 65 64 20 62 79	stderr,."Child.was.terminated.by
22a0	20 73 69 67 6e 61 6c 22 2c 20 2d 72 65 74 63 6f 64 65 0a 20 20 20 20 65 6c 73 65 3a 0a 20 20 20	.signal",.-retcode.....else:....
22c0	20 20 20 20 20 70 72 69 6e 74 20 3e 3e 73 79 73 2e 73 74 64 65 72 72 2c 20 22 43 68 69 6c 64 20	.....print.>>sys.stderr,."Child.
22e0	72 65 74 75 72 6e 65 64 22 2c 20 72 65 74 63 6f 64 65 0a 65 78 63 65 70 74 20 4f 53 45 72 72 6f	returned",.retcode.except.OSErro
2300	72 2c 20 65 3a 0a 20 20 20 20 70 72 69 6e 74 20 3e 3e 73 79 73 2e 73 74 64 65 72 72 2c 20 22 45	r,.e:.....print.>>sys.stderr,."E
2320	78 65 63 75 74 69 6f 6e 20 66 61 69 6c 65 64 3a 22 2c 20 65 0a 0a 0a 52 65 70 6c 61 63 69 6e 67	xecution.failed:",.e...Replacing
2340	20 6f 73 2e 73 70 61 77 6e 2a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 50	.os.spawn*.-------------------.P
2360	5f 4e 4f 57 41 49 54 20 65 78 61 6d 70 6c 65 3a 0a 0a 70 69 64 20 3d 20 6f 73 2e 73 70 61 77 6e	_NOWAIT.example:..pid.=.os.spawn
2380	6c 70 28 6f 73 2e 50 5f 4e 4f 57 41 49 54 2c 20 22 2f 62 69 6e 2f 6d 79 63 6d 64 22 2c 20 22 6d	lp(os.P_NOWAIT,."/bin/mycmd",."m
23a0	79 63 6d 64 22 2c 20 22 6d 79 61 72 67 22 29 0a 3d 3d 3e 0a 70 69 64 20 3d 20 50 6f 70 65 6e 28	ycmd",."myarg").==>.pid.=.Popen(
23c0	5b 22 2f 62 69 6e 2f 6d 79 63 6d 64 22 2c 20 22 6d 79 61 72 67 22 5d 29 2e 70 69 64 0a 0a 0a 50	["/bin/mycmd",."myarg"]).pid...P
23e0	5f 57 41 49 54 20 65 78 61 6d 70 6c 65 3a 0a 0a 72 65 74 63 6f 64 65 20 3d 20 6f 73 2