2. FreeBSD Doc
  3. books_developers-handbook
  4. Persian
  5. Translate

Translation

(itstool) path: sect3/para
This change prevents a mysterious lockup in a very specific case. I refer to it as the <emphasis>dark side of buffering</emphasis>, mostly because it presents a danger that is not quite obvious.
201/1940
Context English Persian State
All parameters are optional, and can appear in any order. تمامی مؤلفه‌ها اختیاری هستند، و می‌توانند به هر ترتیبی آورده شوند.
The <parameter>-t</parameter> parameter declares what to replace the commas with. The <constant>tab</constant> is the default here. For example, <parameter>-t;</parameter> will replace all unquoted commas with semicolons. مؤلفهٔ <parameter>-t</parameter> چیزهایی که با ویرگول جایگزین می‌شوند را اعلان می‌کند. <constant>tab</constant> در اینجا پیش‌فرض است. برای مثال، <parameter>-t;</parameter>تمام ویرگول‌های نقل قول نشده را با نقطه ویرگول جایگزین می‌کند.
I did not need the <parameter>-c</parameter> option, but it may come in handy in the future. It lets me declare that I want a character other than a comma replaced with something else. For example, <parameter>-c@</parameter> will replace all at signs (useful if you want to split a list of email addresses to their user names and domains). من نیازی به گزینهٔ <parameter>-c</parameter> نداشتم، گرچه در آینده ممکن است چاره‌ساز باشد. این امکان را به من می‌دهد تا اعلام کنم به‌جای ویرگول جدا شده با یک چیز دیگر، نویسهٔ دیگری می‌خواهم. برای مثال، <parameter>-c@</parameter> همهٔ at sign ها را جایگزین می‌کند (چنانچه بخواهید از نشانی‌های ایمیل، فهرستی شامل نام‌های کاربری و دامنه‌هایشان را ایجاد کنید).
The <parameter>-p</parameter> option preserves the first line, i.e., it does not delete it. By default, we delete the first line because in a <acronym>CSV</acronym> file it contains the field names rather than data. گزینهٔ <parameter>-p</parameter> سطر نخست را حفظ می‌کند، برای مثال، آن را حذف نمی‌کند. به‌طور پیش‌فرض، سطر نخست را حذف می‌کنیم زیرا در یک پروندهٔ <acronym>CSV</acronym> به‌جای داده، شامل اسامی رشته است.
The <parameter>-i</parameter> and <parameter>-o</parameter> options let me specify the input and the output files. Defaults are <filename>stdin</filename> and <filename>stdout</filename>, so this is a regular <trademark class="registered">UNIX</trademark> filter. گزینه‌های <parameter>-i</parameter> و <parameter>-o</parameter> این امکان را می‌دهند تا ورودی و خروجی پرونده‌ها را تعیین کنم. پیش‌فرض‌ها شامل <filename>stdin</filename> و <filename>stdout</filename> هستند، پس این یک فیلتر عادیِ <trademark class="registered">UNIX</trademark> است.
I made sure that both <parameter>-i filename</parameter> and <parameter>-ifilename</parameter> are accepted. I also made sure that only one input and one output files may be specified. اطمینان پیدا کردم که هر دو <parameter>-i filename</parameter> و <parameter>-ifilename</parameter> پذیرفته می‌شوند. همچنین مطمئن شدم که تنها یک پروندهٔ ورودی و یک پروندهٔ خروجی تعیین گردند.
To get the 11th field of each record, I can now do: برای گرفتن یازدهمین رشته از هر پیشینه، می‌توانم چنین کنم:
<prompt>%</prompt> <userinput>csv '-t;' <replaceable>data.csv</replaceable> | awk '-F;' '{print $11}'</userinput> <prompt>%</prompt> <userinput>csv '-t;' <replaceable>data.csv</replaceable> | awk '-F;' '{print $11}'</userinput>
The code stores the options (except for the file descriptors) in <varname role="register">EDX</varname>: The comma in <varname role="register">DH</varname>, the new separator in <varname role="register">DL</varname>, and the flag for the <parameter>-p</parameter> option in the highest bit of <varname role="register">EDX</varname>, so a check for its sign will give us a quick decision what to do. این کد گزینه‌ها را (به‌غیر از توصیف‌گرهای پرونده) در <varname role="register">EDX</varname> ذخیره می‌کند: ویرگول در <varname role="register">DH</varname>، جداکنندهٔ جدید در <varname role="register">DL</varname>، و نشان گزینهٔ <parameter>-p</parameter> در بالاترین بیت از <varname role="register">EDX</varname>، از این رو بررسی برای علامت آن در تصمیم گیری سریع به ما کمک می‌کند.
Here is the code: کد این است:
;;;;;;; csv.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
; Convert a comma-separated file to a something-else separated file.
;
; Started: 31-May-2001
; Updated: 1-Jun-2001
;
; Copyright (c) 2001 G. Adam Stanislav
; All rights reserved.
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

%include 'system.inc'

%define BUFSIZE 2048

section .data
fd.in dd stdin
fd.out dd stdout
usg db 'Usage: csv [-t&lt;delim&gt;] [-c&lt;comma&gt;] [-p] [-o &lt;outfile&gt;] [-i &lt;infile&gt;]', 0Ah
usglen equ $-usg
iemsg db "csv: Can't open input file", 0Ah
iemlen equ $-iemsg
oemsg db "csv: Can't create output file", 0Ah
oemlen equ $-oemsg

section .bss
ibuffer resb BUFSIZE
obuffer resb BUFSIZE

section .text
align 4
ierr:
push dword iemlen
push dword iemsg
push dword stderr
sys.write
push dword 1 ; return failure
sys.exit

align 4
oerr:
push dword oemlen
push dword oemsg
push dword stderr
sys.write
push dword 2
sys.exit

align 4
usage:
push dword usglen
push dword usg
push dword stderr
sys.write
push dword 3
sys.exit

align 4
global _start
_start:
add esp, byte 8 ; discard argc and argv[0]
mov edx, (',' &lt;&lt; 8) | 9

.arg:
pop ecx
or ecx, ecx
je near .init ; no more arguments

; ECX contains the pointer to an argument
cmp byte [ecx], '-'
jne usage

inc ecx
mov ax, [ecx]

.o:
cmp al, 'o'
jne .i

; Make sure we are not asked for the output file twice
cmp dword [fd.out], stdout
jne usage

; Find the path to output file - it is either at [ECX+1],
; i.e., -ofile --
; or in the next argument,
; i.e., -o file

inc ecx
or ah, ah
jne .openoutput
pop ecx
jecxz usage

.openoutput:
push dword 420 ; file mode (644 octal)
push dword 0200h | 0400h | 01h
; O_CREAT | O_TRUNC | O_WRONLY
push ecx
sys.open
jc near oerr

add esp, byte 12
mov [fd.out], eax
jmp short .arg

.i:
cmp al, 'i'
jne .p

; Make sure we are not asked twice
cmp dword [fd.in], stdin
jne near usage

; Find the path to the input file
inc ecx
or ah, ah
jne .openinput
pop ecx
or ecx, ecx
je near usage

.openinput:
push dword 0 ; O_RDONLY
push ecx
sys.open
jc near ierr ; open failed

add esp, byte 8
mov [fd.in], eax
jmp .arg

.p:
cmp al, 'p'
jne .t
or ah, ah
jne near usage
or edx, 1 &lt;&lt; 31
jmp .arg

.t:
cmp al, 't' ; redefine output delimiter
jne .c
or ah, ah
je near usage
mov dl, ah
jmp .arg

.c:
cmp al, 'c'
jne near usage
or ah, ah
je near usage
mov dh, ah
jmp .arg

align 4
.init:
sub eax, eax
sub ebx, ebx
sub ecx, ecx
mov edi, obuffer

; See if we are to preserve the first line
or edx, edx
js .loop

.firstline:
; get rid of the first line
call getchar
cmp al, 0Ah
jne .firstline

.loop:
; read a byte from stdin
call getchar

; is it a comma (or whatever the user asked for)?
cmp al, dh
jne .quote

; Replace the comma with a tab (or whatever the user wants)
mov al, dl

.put:
call putchar
jmp short .loop

.quote:
cmp al, '"'
jne .put

; Print everything until you get another quote or EOL. If it
; is a quote, skip it. If it is EOL, print it.
.qloop:
call getchar
cmp al, '"'
je .loop

cmp al, 0Ah
je .put

call putchar
jmp short .qloop

align 4
getchar:
or ebx, ebx
jne .fetch

call read

.fetch:
lodsb
dec ebx
ret

read:
jecxz .read
call write

.read:
push dword BUFSIZE
mov esi, ibuffer
push esi
push dword [fd.in]
sys.read
add esp, byte 12
mov ebx, eax
or eax, eax
je .done
sub eax, eax
ret

align 4
.done:
call write ; flush output buffer

; close files
push dword [fd.in]
sys.close

push dword [fd.out]
sys.close

; return success
push dword 0
sys.exit

align 4
putchar:
stosb
inc ecx
cmp ecx, BUFSIZE
je write
ret

align 4
write:
jecxz .ret ; nothing to write
sub edi, ecx ; start of buffer
push ecx
push edi
push dword [fd.out]
sys.write
add esp, byte 12
sub eax, eax
sub ecx, ecx ; buffer is empty now
.ret:
ret 		;;;;;;; csv.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
; Convert a comma-separated file to a something-else separated file.
;
; Started: 31-May-2001
; Updated: 1-Jun-2001
;
; Copyright (c) 2001 G. Adam Stanislav
; All rights reserved.
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

%include 'system.inc'

%define BUFSIZE 2048

section .data
fd.in dd stdin
fd.out dd stdout
usg db 'Usage: csv [-t&lt;delim&gt;] [-c&lt;comma&gt;] [-p] [-o &lt;outfile&gt;] [-i &lt;infile&gt;]', 0Ah
usglen equ $-usg
iemsg db "csv: Can't open input file", 0Ah
iemlen equ $-iemsg
oemsg db "csv: Can't create output file", 0Ah
oemlen equ $-oemsg

section .bss
ibuffer resb BUFSIZE
obuffer resb BUFSIZE

section .text
align 4
ierr:
push dword iemlen
push dword iemsg
push dword stderr
sys.write
push dword 1 ; return failure
sys.exit

align 4
oerr:
push dword oemlen
push dword oemsg
push dword stderr
sys.write
push dword 2
sys.exit

align 4
usage:
push dword usglen
push dword usg
push dword stderr
sys.write
push dword 3
sys.exit

align 4
global _start
_start:
add esp, byte 8 ; discard argc and argv[0]
mov edx, (',' &lt;&lt; 8) | 9

.arg:
pop ecx
or ecx, ecx
je near .init ; no more arguments

; ECX contains the pointer to an argument
cmp byte [ecx], '-'
jne usage

inc ecx
mov ax, [ecx]

.o:
cmp al, 'o'
jne .i

; Make sure we are not asked for the output file twice
cmp dword [fd.out], stdout
jne usage

; Find the path to output file - it is either at [ECX+1],
; i.e., -ofile --
; or in the next argument,
; i.e., -o file

inc ecx
or ah, ah
jne .openoutput
pop ecx
jecxz usage

.openoutput:
push dword 420 ; file mode (644 octal)
push dword 0200h | 0400h | 01h
; O_CREAT | O_TRUNC | O_WRONLY
push ecx
sys.open
jc near oerr

add esp, byte 12
mov [fd.out], eax
jmp short .arg

.i:
cmp al, 'i'
jne .p

; Make sure we are not asked twice
cmp dword [fd.in], stdin
jne near usage

; Find the path to the input file
inc ecx
or ah, ah
jne .openinput
pop ecx
or ecx, ecx
je near usage

.openinput:
push dword 0 ; O_RDONLY
push ecx
sys.open
jc near ierr ; open failed

add esp, byte 8
mov [fd.in], eax
jmp .arg

.p:
cmp al, 'p'
jne .t
or ah, ah
jne near usage
or edx, 1 &lt;&lt; 31
jmp .arg

.t:
cmp al, 't' ; redefine output delimiter
jne .c
or ah, ah
je near usage
mov dl, ah
jmp .arg

.c:
cmp al, 'c'
jne near usage
or ah, ah
je near usage
mov dh, ah
jmp .arg

align 4
.init:
sub eax, eax
sub ebx, ebx
sub ecx, ecx
mov edi, obuffer

; See if we are to preserve the first line
or edx, edx
js .loop

.firstline:
; get rid of the first line
call getchar
cmp al, 0Ah
jne .firstline

.loop:
; read a byte from stdin
call getchar

; is it a comma (or whatever the user asked for)?
cmp al, dh
jne .quote

; Replace the comma with a tab (or whatever the user wants)
mov al, dl

.put:
call putchar
jmp short .loop

.quote:
cmp al, '"'
jne .put

; Print everything until you get another quote or EOL. If it
; is a quote, skip it. If it is EOL, print it.
.qloop:
call getchar
cmp al, '"'
je .loop

cmp al, 0Ah
je .put

call putchar
jmp short .qloop

align 4
getchar:
or ebx, ebx
jne .fetch

call read

.fetch:
lodsb
dec ebx
ret

read:
jecxz .read
call write

.read:
push dword BUFSIZE
mov esi, ibuffer
push esi
push dword [fd.in]
sys.read
add esp, byte 12
mov ebx, eax
or eax, eax
je .done
sub eax, eax
ret

align 4
.done:
call write ; flush output buffer

; close files
push dword [fd.in]
sys.close

push dword [fd.out]
sys.close

; return success
push dword 0
sys.exit

align 4
putchar:
stosb
inc ecx
cmp ecx, BUFSIZE
je write
ret

align 4
write:
jecxz .ret ; nothing to write
sub edi, ecx ; start of buffer
push ecx
push edi
push dword [fd.out]
sys.write
add esp, byte 12
sub eax, eax
sub ecx, ecx ; buffer is empty now
.ret:
ret
Much of it is taken from <filename>hex.asm</filename> above. But there is one important difference: I no longer call <function>write</function> whenever I am outputting a line feed. Yet, the code can be used interactively. بیشتر آن از پروندهٔ بالا، <filename>hex.asm</filename>، آمده است. اما یک تفاوت مهم وجود دارد: من هر زمان که نوسطری ایجاد می‌کنم، دیگر <function>write</function> را فراخوانی نمی‌کنم. با این‌حال، امکان استفادهٔ تعاملی از کد وجود دارد.
I have found a better solution for the interactive problem since I first started writing this chapter. I wanted to make sure each line is printed out separately only when needed. After all, there is no need to flush out every line when used non-interactively. از هنگامی‌که شروع به نوشتن این فصل کرده ام راه حل بهتری برای مشکل تعاملی یافته‌ام. می‌خواستم مطمئن شوم هر سطر تنها زمانی جداگانه چاپ می‌شود که نیاز باشد. به هر حال، در هنگام استفادهٔ غیرتعاملی هیچ نیازی به بسط دادن هر سطر نیست.
The new solution I use now is to call <function>write</function> every time I find the input buffer empty. That way, when running in the interactive mode, the program reads one line from the user's keyboard, processes it, and sees its input buffer is empty. It flushes its output and reads the next line. راه حل جدیدی که اکنون استفاده می‌کنم چنین است که هر زمان که میان‌گیر ورودی خالی است، <function>write</function> را فراخوانی می‌کنم. با این کار، هنگام اجرا در حالت تعاملی، برنامه یک سطر از صفحه کلید کاربر می‌خواند، آن را پردازش می‌کند، و می‌بیند که میان‌گیر ورودی‌اش خالی است. خروجی‌اش را پاک می‌کند و سطر بعدی را می‌خواند.
The Dark Side of Buffering نیمهٔ تاریک میان‌گیری
This change prevents a mysterious lockup in a very specific case. I refer to it as the <emphasis>dark side of buffering</emphasis>, mostly because it presents a danger that is not quite obvious. این تغییر از محبوس شدن در یک مورد بسیار خاص پیش‌گیری می‌کند. من از آن به‌عنوان <emphasis>نیمهٔ تاریک میان‌گیری</emphasis> یاد می‌کنم، بیشتر به این خاطر که خطری را مطرح می‌کند که به‌طور کامل مشهود نیست.
It is unlikely to happen with a program like the <application>csv</application> above, so let us consider yet another filter: In this case we expect our input to be raw data representing color values, such as the <emphasis>red</emphasis>, <emphasis>green</emphasis>, and <emphasis>blue</emphasis> intensities of a pixel. Our output will be the negative of our input. احتمال وقوع آن با برنامه‌ای چون <application>csv</application> که بالاتر آمده است بعید است، از این رو بگذارید فیلتر دیگری را در نظر بگیریم: در این مورد انتظار داریم ورودی‌مان دادهٔ خامی باشد که نشان‌گر مقادیر رنگ باشد، مانند شدت‌های <emphasis>سرخ</emphasis>، <emphasis>سبز</emphasis>، و <emphasis>آبی</emphasis> از یک پیکسل. خروجی ما برخلاف ورودی‌مان خواهد بود.
Such a filter would be very simple to write. Most of it would look just like all the other filters we have written so far, so I am only going to show you its inner loop: نوشتن چنین فیلتری بسیار ساده است. اکثر آن شبیه به تمام فیلترهایی است که تابحال نوشته‌ایم، در نتیجه من فقط حلقه‌های درونی آن را نشان شما خواهم داد:
.loop:
call getchar
not al ; Create a negative
call putchar
jmp short .loop 		.loop:
call getchar
not al ; Create a negative
call putchar
jmp short .loop
Because this filter works with raw data, it is unlikely to be used interactively. چنانکه این فیلتر با داده‌های خام کار می‌کند، بعید است از آن به‌صورت تعاملی استفاده شود.
But it could be called by image manipulation software. And, unless it calls <function>write</function> before each call to <function>read</function>, chances are it will lock up. اما می‌توان نرم‌افزار دستکاری تصویر را فراخوانی کرد. و، به جز آنکه <function>write</function> را قبل از هر فراخوان به <function>read</function> فراخوانی کند، احتمال محبوس شدن آن وجود دارد.
Here is what might happen: آنچه که ممکن است روی دهد:
The image editor will load our filter using the C function <function>popen()</function>. ویرایشگر تصویر فیلتر ما را با استفاده از تابع <function>popen()</function> در C بارگیری می‌کند.
It will read the first row of pixels from a bitmap or pixmap. اولین ردیف از پیکسل‌ها را از یک bitmap یا pixmap می‌خواند.
It will write the first row of pixels to the <emphasis>pipe</emphasis> leading to the <varname>fd.in</varname> of our filter. اولین ردیف از پیکسل‌ها را در <emphasis>pipe</emphasis> منتهی به <varname>fd.in</varname> فیلتر ما می‌نویسد.
Our filter will read each pixel from its input, turn it to a negative, and write it to its output buffer. فیلتر ما هر پیکسل را از ورودی خود می‌خواند، آن را به یک نگاتیو تبدیل می‌کند، و در میان‌گیر ورودی‌اش می‌نویسد.
Our filter will call <function>getchar</function> to fetch the next pixel. فیلتر ما <function>getchar</function> را فراخوانی می‌کند تا پیکسل بعدی را بگیرد.
<function>getchar</function> will find an empty input buffer, so it will call <function>read</function>. <function>getchar</function> یک میان‌گیر ورودی خالی پیدا می‌کند، از این رو <function>read</function> را فراخوانی می‌کند.
<function>read</function> will call the <function role="syscall">SYS_read</function> system call. تابع <function>read</function> فراخوان سامانهٔ <function role="syscall">SYS_read</function> را فراخوانی می‌کند.
The <emphasis>kernel</emphasis> will suspend our filter until the image editor sends more data to the pipe. <emphasis>هسته</emphasis> فیلتر ما را تا زمانی‌که ویرایشگر تصویر داده‌های بیشتری به pipe ارسال کند تعلیق می‌کند.
The image editor will read from the other pipe, connected to the <varname>fd.out</varname> of our filter so it can set the first row of the output image <emphasis>before</emphasis> it sends us the second row of the input.

Loading…

User avatar qps

New translation

FreeBSD Doc / books_developers-handbook — Persian

This change prevents a mysterious lockup in a very specific case. I refer to it as the <emphasis>dark side of buffering</emphasis>, mostly because it presents a danger that is not quite obvious.
این تغییر از محبوس شدن در یک مورد بسیار خاص پیش‌گیری می‌کند. من از آن به‌عنوان <emphasis>نیمهٔ تاریک میان‌گیری</emphasis> یاد می‌کنم، بیشتر به این خاطر که خطری را مطرح می‌کند که به‌طور کامل مشهود نیست.
a month ago
Browse all component changes

Glossary

English Persian
Buffer Overflow سرریز میان‌گیر FreeBSD Doc

Source information

Source string comment
(itstool) path: sect3/para
Source string location
book.translate.xml:12529
String age
6 months ago
Source string age
a year ago
Translation file
books/fa/developers-handbook.po, string 1939