translate SYS V semaphore API slide

Author: Vladimir Kotal

sys-v-semaphores.tex

@@ -8,43 +8,46 @@
 \texttt{int \funnm{semget}(key\_t \emph{key}, int \emph{nsems}, int
 \emph{semflg});}
 \begin{itemize}
-\item vrátí identifikátor pole obsahujícího \texttt{nsems} semaforů asociovaný
-s~klíčem \texttt{key} (klíč \texttt{IPC\_PRIVATE} \dots{} privátní semafory, při
-každém použití vrátí jiný identifikátor). \texttt{semflg} je OR-kombinace
-přístupových práv a konstant \texttt{IPC\_CREAT} (vytvořit, pokud neexistuje),
-\texttt{IPC\_EXCL} (chyba, pokud existuje). 
+\item returns identifier of an array of \texttt{nsems} semaphores associated
+with the \texttt{key} key (\texttt{IPC\_PRIVATE} key \dots{} private semaphores,
+each call returns different identifier). 
+\texttt{semflg} is OR-combination of access rights and constants
+\texttt{IPC\_CREAT} (create if does not exist),
+\texttt{IPC\_EXCL} (error, if exists). 
 \end{itemize}
 \texttt{int \funnm{semctl}(int \emph{semid}, int \emph{semnum},
 int \emph{cmd}, ...);}
 \begin{itemize}
-\item řídicí funkce, volitelný čtvrtý parametr \texttt{arg} je typu
-\texttt{union~semun}. 
+\item controlling function, optional 4th argument \texttt{arg} is of the
+\texttt{union~semun} type.
 \end{itemize}
 \texttt{int \funnm{semop}(int \emph{semid}, struct sembuf *\emph{sops}, size\_t
 \emph{nsops});}
 \begin{itemize}
-\item zobecněné operace P a V.
+\item generic operations P and V.
 \end{itemize}
 \end{slide}
 
 \label{SYSVSEM}
 
 \begin{itemize}
-\item jak získat klíč pro \texttt{semget} je vysvětleno na strane
+\item How to get the key for \texttt{semget} is explained on page
 \pageref{FTOK}.
-\item největší zajímavost na System V implementaci semaforů je skutečnost, že
-daný syscall neoperuje nad jedním semaforem, ale nad \emsl{polem semaforů}, a to
-atomicky. Většinou však budete potřebovat pouze jeden semafor, tj. pole o jednom
-prvku. Pro takové použití jsou System V semafory zbytečně složité.
-\item přístupová práva jsou jen pro čtení a zápis; bit execute zde nemá smysl.
-\item podobné schéma API funkcí (funkce na vytvoření, řízení a operace) dodržují
-i ostatní System V IPC mechanismy.
-\item jakmile je jednou pole semaforů jedním procesem vytvořeno, mohou i ostatní
-procesy použít \texttt{semctl()} a \texttt{semop()}, aniž by předtím volaly
-\texttt{semget()}. To platí i pro semafory vytvořené s klíčem
-\texttt{IPC\_PRIVATE}, pro které nelze volat \texttt{semget()}, protože by se
-tím vytvořilo nové pole semaforů. Je to tak proto, aby i privátní semafory mohly
-být děděné v rámci \texttt{fork}.
+\item The most interesting property of System V semaphore implementation is
+that given syscall does not operate on one semaphore but on \emsl{semaphore
+array}, atomically.
+Most of the time you will need just one semaphore, i.e. array of one item.
+For such use the System V semaphores are needlessly complex.
+\item Access rights are only for reading and writing; the execute bit does not
+make sense in this context.
+\item Similar API (function for creating, control and operations) is followed by
+the other System V IPC mechanism as well.
+\item Once the array of semaphores is created by a process, the other processes
+can use \texttt{semctl()} and \texttt{semop()}, without calling
+\texttt{semget()} beforehand. This is valid also for the semaphores created with
+the \texttt{IPC\_PRIVATE} key, for which it is not possible to call
+\texttt{semget()}, because it would create new semaphore array. This is done so
+that private semaphores can be inherited across \texttt{fork} as well.
 \end{itemize}
 
 %%%%%