BlackArch Linux, BlackArch Linux Rehberi
Transcript of BlackArch Linux, BlackArch Linux Rehberi
BlackArch Linux Rehberi
https://www.blackarch.org/
İçindekiler
1 Giriş 31.1 Ön Bakış . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 BlackArch Linux Nedir? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3 BlackArch Linux Rehberi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.4 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.5 Dahil Olun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Kullanıcı Rehberi 52.1 Kurulum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1.1 Var olan Arch Linux üzerine kurulum . . . . . . . . . . . . . . . . . . . . . . 52.1.2 Paket kurulumu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1.3 Kaynak koddan paket kurulumu . . . . . . . . . . . . . . . . . . . . . . . . 62.1.4 Temel BlackMan kullanımı . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.1.5 Doğrudan çalıştırılabilir ISO ile kurulum yapma . . . . . . . . . . . . . . . . 7
3 Geliştirici Rehberi 83.1 Arch Linux Paket Derleme ve Paket Depoları . . . . . . . . . . . . . . . . . . . . . 83.2 Blackarch PKGBUILD standartları . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2.1 Gruplar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2.1.1 blackarch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2.1.2 blackarch-anti-forensic . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.3 blackarch-automation . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.4 blackarch-backdoor . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.5 blackarch-binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.6 blackarch-bluetooth . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.7 blackarch-code-audit . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.8 blackarch-cracker . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.9 blackarch-crypto . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2.1.10 blackarch-database . . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.11 blackarch-debugger . . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.12 blackarch-decompiler . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.13 blackarch-defensive . . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.14 blackarch-disassembler . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.15 blackarch-dos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.16 blackarch-drone . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.17 blackarch-exploitation . . . . . . . . . . . . . . . . . . . . . . . . . 103.2.1.18 blackarch-fingerprint . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.19 blackarch-firmware . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.20 blackarch-forensic . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.21 blackarch-fuzzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2
3.2.1.22 blackarch-hardware . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.23 blackarch-honeypot . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.24 blackarch-keylogger . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.25 blackarch-malware . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1.26 blackarch-misc . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.27 blackarch-mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.28 blackarch-networking . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.29 blackarch-nfc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.30 blackarch-packer . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.31 blackarch-proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.32 blackarch-recon . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.33 blackarch-reversing . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2.1.34 blackarch-scanner . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.35 blackarch-sniffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.36 blackarch-social . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.37 blackarch-spoof . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.38 blackarch-threat-model . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.39 blackarch-tunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.40 blackarch-unpacker . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.41 blackarch-voip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.1.42 blackarch-webapp . . . . . . . . . . . . . . . . . . . . . . . . . . . 143.2.1.43 blackarch-windows . . . . . . . . . . . . . . . . . . . . . . . . . . 143.2.1.44 blackarch-wireless . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.3 Repository structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143.3.1 Betikler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4 Depoya katkıda bulunmak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.4.1 Yardımcı kaynaklar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.4.2 Katkı aşamaları . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.4.3 Örnek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.4.3.1 PKGBUILD elde etme . . . . . . . . . . . . . . . . . . . . . . . . 163.4.3.2 PKGBUILD temizleme . . . . . . . . . . . . . . . . . . . . . . . . 173.4.3.3 PKGBUILD ayarlama . . . . . . . . . . . . . . . . . . . . . . . . . 173.4.3.4 Paket derleme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.4.3.5 Paketin kurulumu ve test edilmesi . . . . . . . . . . . . . . . . . . 173.4.3.6 Git’e gönderme . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.4.3.7 İstek gönderme . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.4.3.8 Güncellemeleri takip etmek . . . . . . . . . . . . . . . . . . . . . . 18
3.4.4 İstekler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.4.5 Genel ipuçları . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4 Araç Rehberi 194.1 Yakında . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
A Apéndice 20A.1 FAQ’s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20A.2 AUTORES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Bölüm 1
Giriş
1.1 Ön Bakış
Bu rehber 4 ana parçaya bölünmüştür:
• Giriş - Projeye genel bir bakış, giriş ve çeşitli yararlı ilk bilgiler
• Kullanıcı Rehberi - Normal bir kullanıcının BlackArch’ı verimli kullanması için gerekli bilgiler
• Geliştirici Rehberi - BlackArch’ın geliştirilmesine yardımcı veya destek olmak isteyenler içingerekli bilgiler
• Araç Rehberi - Kurulu araçların kullanım yöntemleri ve ipuçları
1.2 BlackArch Linux Nedir?
BlackArch, siber güvenlik araştırmacıları ve sızma testi uzmanları için geliştirilmekte olan birGNU/Linux dağıtımıdır. ArchLinux işletim sistemini taban olarak kabul etmiştir ve kullanıcılaraBlackArch paketlerini kurma imkanı sağlamaktadır. Kullanıcılar bu paketleri grup olarak yükleye-bileceği gibi, doğrudan da yükleyebilir.
Araçların yer aldığı paket deposu, Arch Linux işletim sisteminde olduğu gibi resmi olmayan kullanıcıdeposu olarak kullanılabilir. Doğal olarak hali hazırda kurulu olan Arch Linux işletim sistemine kurulumyapılabilir. Paket deposu eklemesi yapıldıktan sonra araçlar doğrudan veya gruplar halinde kurulabilir.
Şu anda depo içerisinde 2600 araç bulunmaktadır. Depo kalitesinin korunması için tüm araçlar ek-lenmeden önce test edilmektedir.
1.3 BlackArch Linux Rehberi
Yakında...
1.4 Supported platforms
Yakında...
4
The BlackArch Linux Rehberi
1.5 Dahil Olun
BlackArch ekibi ile aşağıdaki yöntemlerden istediğiniz birisi ile iletişime geçebilirsiniz:
Web sitesi: https://www.blackarch.org/
E-Posta adresi: [email protected]
IRC: irc://irc.freenode.net/blackarch
Twitter: https://twitter.com/blackarchlinux
Github: https://github.com/Blackarch/
Discord: https://discord.com/invite/xMHt8dW
5
Bölüm 2
Kullanıcı Rehberi
2.1 Kurulum
Bu kısım altında BlackArch deposunun nasıl sisteme dahil edileceği ve paketlerin nasıl kurulacağı yeralmaktadır. BlackArch depolarda yer alan derlenmiş paketleri desteklediği gibi kaynak kod ile paketkurulumunu da desteklemektedir.
BlackArch normal bir Arch Linux kurulumu ile uyumludur. Resmi olmayan kullanıcı deposu olarakdüşünülebilir. Paket deposu yerine doğrudan ISO ile kurulum yapmak isterseniz Live ISO kısmınabakabilirsiniz.
2.1.1 Var olan Arch Linux üzerine kurulum
strap.sh betiğini root yetkileri ile çalıştırınız ve aşağıdaki adımları takip ediniz. Hash değeri kontrolünüyapmayı unutmayınız.
curl -O https://blackarch.org/strap.shsha1sum strap.sh # bu degere esit olmali: d062038042c5f141755ea39dbd615e6ff9e23121sudo chmod +x strap.shsudo ./strap.sh
Şimdi, ana paket listesinin güncellenmesi ve paketlerinizin senkron olması için aşağıdaki komutukullanınız:
sudo pacman -Syyu
2.1.2 Paket kurulumu
Araçları blackarch deposundan kurabilirsiniz.
1. Kurulabilir tüm araçları listelemek için:pacman -Sgg | grep blackarch | cut -d' ' -f2 | sort -u
2. Tüm araçları kurmak için:
6
The BlackArch Linux Rehberi
pacman -S blackarch
3. Belirli bir kategoride yer alan araçları kurmak için:pacman -S blackarch -<category >
4. Tüm blackarch kategorilerini görmek için:pacman -Sg | grep blackarch
2.1.3 Kaynak koddan paket kurulumu
Kurulumlara alternatif olarak BlackArch paketlerini doğrudan kaynak kod yardımı ile kurabilirsiniz.Bunun için PKGBUILD dosyalarına paketler dizini altından erişebilirsiniz. Tüm depoyu derlemek içinBlackman aracını kullanabilirsiniz.
• BlackArch paket deposu sisteminizde ekliyse doğrudan aşağıdaki komut yardımıyla Blackmanaracını kurabilirsiniz.
pacman -S blackman
• Blackman’i kaynak koddan kurmak için aşağıdaki adımları takip edebilirsiniz.mkdir blackmancd blackmanwget https://raw.github.com/BlackArch/blackarch/master/packages/blackman/PKGBUILD# PKGBUILD dosyasinda herhangi bir sikinti olmadigini kontrol etmeyi unutmayiniz!makepkg -s
• Blackman’i AUR aracılığı ile de kurabilirsiniz.<AUR yardimci araciniz > -S blackman
2.1.4 Temel BlackMan kullanımı
Blackman her ne kadar alıştığınız diğer paket yöneticilerinin parametrelerinden farklı bir yapı kullansada, gayet kolay bir kullanıma sahiptir. En temel kullanımı aşağıda gösterilmiştir.
• Paketi indir, derle ve kur:sudo blackman -i paket
• Paket grubunu indir, derle ve içerisinde yer alan tüm paketleri kur:sudo blackman -g grup
• Tüm BlackArch araçlarını indir, derle ve kur:sudo blackman -a
7
The BlackArch Linux Rehberi
• BlackArch kategorilerini listeleme:blackman -l
• Kategori içerisinde yer alan araçları listeleme:blackman -p category
2.1.5 Doğrudan çalıştırılabilir ISO ile kurulum yapma
BlackArch’ı doğrudan çalıştırılabilir ISO aracılığı ile de kurabilirsiniz. Bunun için https://www.blackarch.org/download.html#iso sayfasından bulabileceğiniz imaj ile aşağıdaki adımları takipedebilirsiniz. Adımları takip edebilmek için bilgisayarınızı indirdiğiniz imaj ile boot etmeniz gerekmek-tedir.
• blackarch-installer paketi kurulumu:sudo pacman -S blackarch -installer
• Çalıştırmasudo blackarch -install
8
Bölüm 3
Geliştirici Rehberi
3.1 Arch Linux Paket Derleme ve Paket Depoları
PKGBUILD dosyaları derleme betikleridir. Bu betikler makepkg(1) uygulamasına paketin nasıl oluş-turulacağı bilgisini sağlamaktadır. PKGBUILD dosyaları Bash betikleri olarak yazılmaktadır.
Daha fazla bilgi için aşağıdaki kaynaklara bakabilirsiniz:
• Arch Wiki: Paket Oluşturulması
• Arch Wiki: makepkg
• Arch Wiki: PKGBUILD
• Arch Wiki: Arch Paketleri Standartları
3.2 Blackarch PKGBUILD standartları
AUR deposundaki paketler ile benzerliği korumak için PKGBUILD dosyaları ufak farklar haricindebenzer şekilde oluşturulmaktadır. Her bir paket en az blackarch grubuna dahil olmalıdır. Benzerşekilde bir paket birden fazla gruba dahil olabileceği gibi bir grup içerisinde de birden fazla paketbulunabilir.
3.2.1 Gruplar
Kullanıcılar kolay ve hızlı bir şekilde benzer paketleri kurabilmesi için çeşitli gruplamalar yapılmıştır.Gruplamanın getirdiği avantaj sayesinde ”pacman -S <grup_adi>” şeklinde bir komut ile tüm paketlerkurulabilir.
3.2.1.1 blackarch
”blackarch” grubu diğer tüm grupların dahil olmak zorunda olduğu temel gruptur. Bu, tüm kul-lanıcıların tüm paketleri rahatlıkla kurmasını sağlar.
Bu grupta ne bulunabilir? Herşey.
9
The BlackArch Linux Rehberi
3.2.1.2 blackarch-anti-forensic
Şifreleme, steganografi ve dosya özelliklerini düzenleme işlemlerini içeren adli bilişim işlemleri içinkullanılan paketlerdir. İçerdiği tüm araçların amacı sistemde bilgi gizlemek için değişiklik yapmaktır.
Örnek: luks, TrueCrypt, Timestomp, dd, ropeadope, secure-delete
3.2.1.3 blackarch-automation
Araçların veya iş akışının düzenlenmesi için kullanılan paketlerdir.
Örnek: blueranger, tiger, wiffy
3.2.1.4 blackarch-backdoor
Zafiyetli sistemlerdeki açık backdoorlar veya exploitlerdir.
Örnek: backdoor-factory, rrs, weevely
3.2.1.5 blackarch-binary
Bazı formlardaki binary dosya işlemleri için kullanılan paketlerdir.
Örnek: binwally, packerid
3.2.1.6 blackarch-bluetooth
Bluetooth standardı(802.15.1) ile alakalı exploitlerdir.
Örnek: ubertooth, tbear, redfang
3.2.1.7 blackarch-code-audit
Zafiyet analizi için kaynak kod denetimi yapan paketlerdir.
Örnek: flawfinder, pscan
3.2.1.8 blackarch-cracker
Hash gibi kriptografik fonksiyonların cracklenmesinde kullanılan paketlerdir.
Örnek: hashcat, john, crunch
3.2.1.9 blackarch-crypto
Crack işlemleri haricindeki kriptografik işlemlerde kullanılan paketlerdir.
Örnek: ciphertest, xortool, sbd
10
The BlackArch Linux Rehberi
3.2.1.10 blackarch-database
Herhangi bir seviyedeki veritabanı exploitlerini içeren palketlerdir.
Örnek: metacoretex, blindsql
3.2.1.11 blackarch-debugger
Belirli bir programın realtime’da yaptığı işi incelemeye yarayan paketlerdir.
Örnek: radare2, shellnoob
3.2.1.12 blackarch-decompiler
Derlenmiş programları kaynak koduna çevirmeye yarayan paketlerdir.
Örnek: flasm, jd-gui
3.2.1.13 blackarch-defensive
Kullanıcıyı zararlı yazılımlardan ve saldırılardan koruyan paketlerdir.
Örnek: arpon, chkrootkit, sniffjoke
3.2.1.14 blackarch-disassembler
Bu paketler blackarch-decompiler paketlerine benzer ve bir çok paket her iki grupta da bulunabilir.Bunların farkı ise binary dosyayı reverse ederek kaynak kodu yerine assembly çıktısı verirler.
Örnek: inguma, radare2
3.2.1.15 blackarch-dos
DoS (Denial of Service) saldırıları için kullanılan paketlerdir.
Örnek: 42zip, nkiller2
3.2.1.16 blackarch-drone
Fiziksel olarak drone’ları yönetmek için kullanılan paketlerdir.
Örnek: meshdeck, skyjack
3.2.1.17 blackarch-exploitation
Diğer program ve servisleri exploit ederken avantaj sağlayan paketlerdir.
Örnek: armitage, metasploit, zarp
11
The BlackArch Linux Rehberi
3.2.1.18 blackarch-fingerprint
Parmak izi biyometrik okuyucuların exploit edilmesinde kullanılan paketlerdir.
Örnek: dns-map, p0f, httprint
3.2.1.19 blackarch-firmware
Firmware’deki zafiyetlerin exploit edilmesinde kullanılan paketlerdir.
Örnek: Henüz yok, en kısa sürede değiştirilecek.
3.2.1.20 blackarch-forensic
Fiziksel disk ve hafızadaki verilerin bulunmasında kullanılan paketlerdir.
Örnek: aesfix, nfex, wyd
3.2.1.21 blackarch-fuzzer
Fuzzing işlemlerinde kullanılan paketlerdir. Örneğin bu paketlerle hedefe random değerler gönderereksonucunda ne olduğunu inceleyebilirsiniz.
Örnek: msf, mdk3, wfuzz
3.2.1.22 blackarch-hardware
Fiziksel donanım ile yapılabilecek şeyleri yönetmek veya exploit etmek için kullanılan paketlerdir.
Örnek: arduino, smali
3.2.1.23 blackarch-honeypot
”Honeypot” görevi gören araçlardır. Honeypot’lar saldırganları tuzağa düşürmek için kullanılan pro-gramlardır.
Örnek: artillery, bluepot, wifi-honey
3.2.1.24 blackarch-keylogger
Bir sistemdeki klavye girdilerini saklayan paketlerdir.
Örnek: Henüz yok, en kısa sürede değiştirilecek.
3.2.1.25 blackarch-malware
Malware’lerin veya zararlı olabilecek yazılımların tespitinde kullanılan paketlerdir.
Örnek: malwaredetect, peepdf, yara
12
The BlackArch Linux Rehberi
3.2.1.26 blackarch-misc
Başka herhangi bir gruba ait olmayan paketlerdir.
Örnek: oh-my-zsh-git, winexe, stompy
3.2.1.27 blackarch-mobile
Mobil platformların manipüle edilmesinde kullanılan paketlerdir.
Örnek: android-sdk-platform-tools, android-udev-rules
3.2.1.28 blackarch-networking
Network işlemlerinde kullanılan paketlerdir.
Örnek: Hemen hemen herşey
3.2.1.29 blackarch-nfc
NFC (near-field communications) işlemlerinde kullanılan paketlerdir.
Örnek: nfcutils
3.2.1.30 blackarch-packer
Packerları içeren paketlerdir.
Packerlar diğer yazılımlara zararlı yazılım gömebilen paketlerdir.
Örnek: packerid
3.2.1.31 blackarch-proxy
Proxy görevi görevi gören uygulamalardır. Proxy’ler trafiği internetteki başka node’lar üzerindengeçiren yapılardır.
Örnek: burpsuite, ratproxy, sslnuke
3.2.1.32 blackarch-recon
Aktif zafiyet taraması yapan paketlerdir. Daha çok benzer paketlerin bir araya toplandığı şemsiyegörevi görür.
Örnek: canri, dnsrecon, netmask
3.2.1.33 blackarch-reversing
Decompiler, disassembler gruplarının veya benzer programların bir araya toplandığı gruptur.
Örnek: capstone, radare2, zerowine
13
The BlackArch Linux Rehberi
3.2.1.34 blackarch-scanner
Hedef sistemde zafiyet taraması yapan paketlerdir.
Örnek: scanssh, tiger, zmap
3.2.1.35 blackarch-sniffer
Ağ trafiğini analiz etmeye yarayan paketlerdir.
Örnek: hexinject, pytactle, xspy
3.2.1.36 blackarch-social
Öncelikli olarak sosyal ağ sitelerine saldırmaya yarayan paketlerdir.
Örnek: jigsaw, websploit
3.2.1.37 blackarch-spoof
Saldırganın kendisini gizleyerek kurbanı aldatma girişimlerinde kullandığı paketlerdir.
Examples: arpoison, lans, netcommander
3.2.1.38 blackarch-threat-model
Belirli bir senaryoda verilen tehdit modelini kaydetmek/raporlamak için kullanılan araçlardır.
Örnek: magictree
3.2.1.39 blackarch-tunnel
Verilen ağa tünnel ap trafiği oluşturmak için kullanılan paketlerdir.
Örnek: ctunnel, iodine, ptunnel
3.2.1.40 blackarch-unpacker
Çalıştırılabilir dosyalara yerleştirilmiş zararlı yazılımları çıkarmak için kullanılan paketlerdir.
Örnek: js-beautify
3.2.1.41 blackarch-voip
Voip programları ve protokolleri üzerinde işlem yapan paketlerdir.
Örnek: iaxflood, rtp-flood, teardown
14
The BlackArch Linux Rehberi
3.2.1.42 blackarch-webapp
İnternet arayüzü olan uygulamaların işlemlerinde kullanılan paketlerdir.
Örnek: metoscan, whatweb, zaproxy
3.2.1.43 blackarch-windows
”wine” ile çalışan windows uygulamalarının bulunduğu paketlerdir.
Örnek: 3proxy-win32, pwdump, winexe
3.2.1.44 blackarch-wireless
Kablosuz ağ işlemleri yapan paketlerdir.
Örnek: airpwn, mdk3, wiffy
3.3 Repository structure
Ana BlackArch git deposuna buradan erişebilirsiniz: https://github.com/BlackArch/blackarch.Bir kaç tane ikincil depoya da erişmek için aşağıdaki linki kullanabilirsiniz:https://github.com/BlackArch.
Ana git deposunda üç önemli klasör bulunmaktadır:
• docs - Dökümantasyon.
• packages - PKGBUILD dosyaları.
• scripts - Basit kullanışlı scriptler.
3.3.1 Betikler
Aşağıda scripts/ klasöründe bulunan betikler için referanslar listelenmiştir:
• baaur - Yakında. Paketleri AUR’a yüklemek için kullanılacak.
• babuild - Paketleri derler.
• bachroot - Test için chroot’u yönetir.
• baclean - Eski .pkg.tar.xz dosyalarını paket deposundan temizler.
• baconflict - Yakında. scripts/conflicts’leri düzeltecek.
• bad-files - Derlenmiş paketlerdeki hatalı dosyaları bulur.
• balock - Paket deposunu kilitler/açar.
• banotify - Paket değişiklerinden IRC’yi haberdar eder.
15
The BlackArch Linux Rehberi
• barelease - Paketleri paket deposuna gönderir.
• baright - BlackArch copyright bilgisini bastırır.
• basign - Paketleri imzalar.
• basign-key - Anahtarları imzalar.
• blackman - Bir nevi pacman gibi davranır, fakat paketleri git’ten çeker. (nrz’nin Blackman’indenfarklıdır.).
• check-groups - Grupları kontrol eder.
• checkpkgs - Paketlerdeki hataları kontrol eder.
• conflicts - Dosya çakışmalarını kontrol eder.
• dbmod - Paket veritabanını düzenler.
• depth-list - Bağımlılık(dependency) derinliğine göre liste oluşturur.
• deptree - Yalnızca blackarch tarafından sunulan paketleri listeleyerek bağımlılık ağacını oluştu-rur.
• get-blackarch-deps - Bir paket için blackarch bağımlılıklarını listeler.
• get-official - Yayınlanacak resmi paketleri listeler.
• list-loose-packages - Herhangi bir grupta yer almayan veya diğer paketlerle bağımlılığı olmayanpaketleri listeler.
• list-needed - Eksik bağımlılıkları listeler.
• list-removed - Paket deposunda bulunan, git’te bulunmayan paketleri listeler.
• list-tools - Araçları listeler.
• outdated - Paket deposunda bulunan paketlerin versiyonlarının git deposuna göre eski olanlarıbulur.
• pkgmod - Derlenmiş bir pakette değişiklik yapar.
• pkgrel - Bir paketteki pkgrel’i artırır.
• prep - PKGBUILD dosyalarını temizler ve hataları bulur.
• sitesync - Bir paketin paket deposundaki local kopyası ile uzak sunucudaki kopyası arasındasenkronizasyon sağlar.
• size-hunt - Büyük paketleri arar.
• source-backup - Paketlerin kaynak dosyalarını yedekler.
16
The BlackArch Linux Rehberi
3.4 Depoya katkıda bulunmak
Bu bölüm BlackArch Linux projesine nasıl katkıda bulunabileceğinizi anlatmaktadır. Küçük harfhatalası düzeltmelerinden yeni paketlere kadar her türlü pull request’ler kabul edilmektedir.Yardımcı olmak, öneride bulunmak veya soru sormak için bizimle iletişime geçebilirsiniz.
Herkes katkıda bulunabilir. Tüm destekler değerlendirilecektir.
3.4.1 Yardımcı kaynaklar
Lütfen katkıda bulunmadan önce aşağıdaki kısmı okuyunuz:
• Arch Paketleme Standartları
• Paket Oluşturma
• PKGBUILD
• Makepkg
3.4.2 Katkı aşamaları
BlackArch Linux projesine değişikliklerinizi göndermek için aşağıdaki adımları takip edebilirsiniz:
1. Depoyu https://github.com/BlackArchLinux/blackarchlinux adresinden forklayın.
2. Gerekli dosyaları düzenleyin, (e.g. PKGBUILD, .patch dosyaları, vb).
3. Değişikliklerinizi commitleyin.
4. Değişikliklerinizi pushlayın.
5. Tercihen pull request ile değişikliklerinizi birleştirmemizi isteyin.
3.4.3 Örnek
Aşağıdaki örnek yeni bir paketi BlackArch projesine göndermeyi göstermektedir. nfsshell için öncedenvar olan PKGBUILD dosyasını almak için yaourt kullanıyoruz (isterseniz pacaur’da kullanabilirsiniz.)ve ihtiyaçlarımıza göre ayarlıyoruz.
3.4.3.1 PKGBUILD elde etme
Yaourt veya pacaur kullanarak PKGBUILD dosyasını alıyoruz:user@blackarchlinux $ yaourt -G nfsshell==> Download nfsshell sourcesx LICENSEx PKGBUILDx gcc.patchuser@blackarchlinux $ cd nfsshell/
17
The BlackArch Linux Rehberi
3.4.3.2 PKGBUILD temizleme
PKGBUILD dosyasını temizleyerek biraz zaman kazanıyoruz:user@blackarchlinux nfsshell $ ./blarckarch/scripts/prep PKGBUILDcleaning 'PKGBUILD '...expanding tabs...removing vim modeline...removing id comment...removing contributor and maintainer comments...squeezing extra blank lines...removing '|| return '...removing leading blank line...removing $pkgname...removing trailing whitespace...
3.4.3.3 PKGBUILD ayarlama
PKGBUILD dosyasını ayarlıyoruz:user@blackarchlinux nfsshell $ vi PKGBUILD
3.4.3.4 Paket derleme
Paketi derliyoruz:==> Making package: nfsshell 19980519-1 (Mon Dec 2 17:23:51 CET 2013)==> Checking runtime dependencies...==> Checking buildtime dependencies...==> Retrieving sources...-> Downloading nfsshell.tar.gz...% Total % Received % Xferd Average Speed Time Time TimeCurrentDload Upload Total Spent Left Speed100 29213 100 29213 00 48150 0 --:--:-- --:--:-- --:--:-- 48206-> Found gcc.patch-> Found LICENSE...<lots of build process and compiler output here>...==> Leaving fakeroot environment.==> Finished making: nfsshell 19980519-1 (Mon Dec 2 17:23:53 CET 2013)
3.4.3.5 Paketin kurulumu ve test edilmesi
Paketi kurup test ediyoruz: Install and test the package:user@blackarchlinux nfsshell $ pacman -U nfsshell -19980519-1-x86_64.pkg.tar.xzuser@blackarchlinux nfsshell $ nfsshell # test it
18
The BlackArch Linux Rehberi
3.4.3.6 Git’e gönderme
Paketi commitleyip git’e gönderiyoruz:user@blackarchlinux ~/blackarchlinux/packages $ mv ~/nfsshell .user@blackarchlinux ~/blackarchlinux/packages $ git commit -am nfsshell && git push
3.4.3.7 İstek gönderme
github.com üzerinden pull request oluşturuyoruz:firefox https://github.com/<contributor >/blackarchlinux
3.4.3.8 Güncellemeleri takip etmek
Eğer kendi forkladığınız depo üzerinde çalışıyorsanız ve ana ba deposunu uzak depo olarak belirlediy-seniz güncellemeleri takip etmek için yapılacaklar:
user@blackarchlinux ~/blackarchlinux $ git remote -vorigin <the url of your fork> (fetch)origin <the url of your fork> (push)user@blackarchlinux ~/blackarchlinux $ git remote add upstream https://github.com/blackarch/blackarchuser@blackarchlinux ~/blackarchlinux $ git remote -vorigin <the url of your fork> (fetch)origin <the url of your fork> (push)upstream https://github.com/blackarch/blackarch (fetch)upstream https://github.com/blackarch/blackarch (push)
Git varsayılan olarak origin’e gönderir ama git config dosyanızın doğru ayarlandığından emin olmanızgerekir. Normal commitler sırasında bu problem olmaz fakat eğer uzak sunucuya göndermek istersenizbu mümkün olmayacaktır.
Eğer yapabiliyorsanız [email protected]:blackarch/blackarch.git kullanarak commitlerinizi yapmanızdaha başarılı olacaktır. Fakat bu konuda tercih size kalmış.
3.4.4 İstekler
1. Maintainer ya da Contributor isimlerini yorum olarak PKGBUILD dosyalarına eklemeyin.Maintainer ve contributor isimlerini BlackArch rehberindeki AUTHORS bölümüne ekleye-bilirsiniz.
2. Tutarlılığa uyması adına depoda bulunan başka bir PKGBUILD dosyasının genel stilini kul-lanınız. Ayrıca girintilerde iki boşluk kullanınız.
3.4.5 Genel ipuçları
namcap ile paket hatalarını kontrol edebilirsiniz.
19
Bölüm 4
Araç Rehberi
Yakında...
4.1 Yakında
Yakında...
20
Appendix A
Apéndice
A.1 FAQ’s
A.2 AUTORES
Las siguientes personas han colaborado directamente en BlackArch:
• Tyler Bennnett ([email protected])
• fnord0 ([email protected])
• nrz ([email protected])
• Ellis Kenyo ([email protected])
• CaledoniaProject ([email protected])
• sudokode ([email protected])
• Valentin Churavy ([email protected])
• Boy Sandy Gladies Arriezona ([email protected])
• Mathias Nyman
• Johannes Löthberg ([email protected])
• Thiago da Silva Teixeira ([email protected])
Las siguientes personas han colaborado directamente en ArchPwn, y se han unido a BlackArch:
• Francesco Piccinno ([email protected])
• jensp ([email protected])
• Valentin Churavy ([email protected])
Hemos tomado build code de las siguientes personas:
21
The BlackArch Linux Rehberi
• 3ED ([email protected])
• AUR Perl ([email protected])
• Aaron Griffin ([email protected])
• Abakus ([email protected])
• Adam Wolk ([email protected])
• Aleix Pol ([email protected])
• Aleshus ([email protected])
• Alessandro Pazzaglia ([email protected])
• Alessandro Sagratini ([email protected])
• Alex Cartwright ([email protected])
• Alexander De Sousa ([email protected])
• Alexander Rødseth ([email protected])
• Allan McRae ([email protected])
• AmaN ([email protected])
• Andre Klitzing ([email protected])
• Andrea Scarpino ([email protected])
• Andreas Schönfelder ([email protected])
• Andrej Gelenberg ([email protected])
• Angel Velasquez ([email protected])
• Antoine Lubineau ([email protected])
• Anton Bazhenov ([email protected])
• Arkham ([email protected])
• Arthur Danskin ([email protected])
• Balda ([email protected])
• Balló György ([email protected])
• Bartek Piotrowski ([email protected])
• Bartosz Feński ([email protected])
• Bartłomiej Piotrowski ([email protected])
• Bogdan Szczurek ([email protected])
• Brad Fanella ([email protected])
22
The BlackArch Linux Rehberi
• Brian Bidulock ([email protected])
• C Anthony Risinger ([email protected])
• CRT ([email protected])
• Can Celasun ([email protected])
• Chaniyth ([email protected])
• Chris Brannon ([email protected])
• Chris Giles ([email protected]) & daschu117
• Christoph Siegenthaler ([email protected])
• Christoph Zeiler ([email protected])
• Clément DEMOULINS ([email protected])
• Corrado Primier ([email protected])
• Daenyth ([email protected])
• Dale Blount ([email protected])
• Damir Perisa ([email protected])
• Dan Fuhry ([email protected])
• Dan Serban ([email protected])
• Daniel A. Campoverde Carrión
• Daniel Golle
• Daniel Griffiths ([email protected])
• Daniel J Griffiths ([email protected])
• Daniel Micay ([email protected])
• Dave Reisner ([email protected])
• Dawid Wrobel ([email protected])
• Devaev Maxim ([email protected])
• Devin Cofer ([email protected])
• DigitalPathogen ([email protected])
• DigitalPathogen ([email protected])
• Dmitry A. Ilyashevich ([email protected])
• Dominik Heidler ([email protected])
• DrZaius ([email protected])
23
The BlackArch Linux Rehberi
• Ebubekir KARUL ([email protected])
• Eduard ”bekks” Warkentin ([email protected])
• Elmo Todurov ([email protected])
• Emmanuel Gil Peyrot ([email protected])
• Eric Belanger ([email protected])
• Ermak ([email protected])
• Evangelos Foutras ([email protected])
• Fabian Melters ([email protected])
• Fabiano Furtado ([email protected])
• Federico Quagliata ([email protected])
• Firmicus (francois.archlinux@org)
• Florian Pritz ([email protected])
• Florian Pritz ([email protected])
• Francesco Piccinno ([email protected])
• François Charette ([email protected])
• Gaetan Bisson ([email protected])
• Geoffroy Carrier ([email protected])
• Georg Grabler (STiAT)
• George Hilliard ([email protected])
• Gerardo Exequiel Pozzi ([email protected])
• Gilles CHAUVIN ([email protected])
• Giovanni Scafora ([email protected])
• Gordin ([email protected])
• Guillaume ALAUX ([email protected])
• Guillermo Ramos ([email protected])
• Gustavo Alvarez ([email protected])
• Hugo Doria ([email protected])
• Hyacinthe Cartiaux ([email protected])
• James Fryman ([email protected])
• Jan ”heftig” Steffens ([email protected])
24
The BlackArch Linux Rehberi
• Jan de Groot ([email protected])
• Jaroslav Lichtblau ([email protected])
• Jaroslaw Swierczynski ([email protected])
• Jason Chu ([email protected])
• Jason R Begley ([email protected])
• Jason Rodriguez
• Jason St. John ([email protected])
• Jawmare ([email protected])
• Jeff Mickey ([email protected])
• Jens Pranaitis ([email protected])
• Jens Pranaitis ([email protected])
• Jinx ([email protected])
• John D Jones III ([email protected])
• John Proctor ([email protected])
• Jon Bergli Heier ([email protected])
• Jonas Heinrich
• Jonathan Steel ([email protected])
• Joris Steyn ([email protected])
• Josh VanderLinden ([email protected])
• Jozef Riha ([email protected])
• Judd Vinet ([email protected])
• Juergen Hoetzel ([email protected])
• Juergen Hoetzel ([email protected])
• Justin Davis ([email protected])
• Kaiting Chen ([email protected])
• Kaos
• Kevin Piche ([email protected])
• Kory Woods ([email protected])
• Kyle Keen ([email protected])
• Larry Hajali ([email protected])
25
The BlackArch Linux Rehberi
• LeCrayonVert
• Le_suisse ([email protected])
• Lekensteyn ([email protected])
• Limao Luo ([email protected])
• Lucien Immink
• Lukas Fleischer ([email protected])
• Manolis Tzanidakis
• Marcin ”avalan” Falkiewicz ([email protected])
• Mariano Verdu ([email protected])
• Marti Raudsepp ([email protected])
• MatToufoutu ([email protected])
• Matthew Sharpe ([email protected])
• Mauro Andreolini ([email protected])
• Max Pray a.k.a. Synthead ([email protected])
• Max Roder ([email protected])
• Maxwell Pray a.k.a. Synthead ([email protected])
• Maxwell Pray a.k.a. Synthead ([email protected])
• Mech ([email protected])
• Michael Düll ([email protected])
• Michael P ([email protected])
• Michal Krenek ([email protected])
• Michal Zalewski ([email protected])
• Miguel Paolino ([email protected])
• Miguel Revilla ([email protected])
• Mike Roberts ([email protected])
• Mike Sampson ([email protected])
• Nassim Kacha ([email protected])
• Nicolas Pouillard ([email protected])
• Nicolas Pouillard https://nicolaspouillard.fr
• Niklas Schmuecker
26
The BlackArch Linux Rehberi
• Oleander Reis ([email protected])
• Olivier Le Moal ([email protected])
• Olivier Médoc ”oliv” ([email protected])
• Pascal E. ([email protected])
• Patrick Leslie Polzer ([email protected])
• Paul Mattal ([email protected])
• Paul Mattal ([email protected])
• Pengyu CHEN ([email protected])
• Peter Wu ([email protected])
• Philipp ’TamCore’ B. ([email protected])
• Pierre Schmitz ([email protected])
• Pranay Kanwar ([email protected])
• Pranay Kanwar ([email protected])
• PyroPeter ([email protected])
• PyroPeter (googlemail.com@abi1789)
• Ray Rashif ([email protected])
• Remi Gacogne
• Renan Fernandes ([email protected])
• Richard Murri ([email protected])
• Roberto Alsina ([email protected])
• Robson Peixoto ([email protected])
• Roel Blaauwgeers ([email protected])
• Rorschach ([email protected])
• Ruben Schuller ([email protected])
• Rudy Matela ([email protected])
• Ryon Sherman ([email protected])
• Sabart Otto
• Seberm ([email protected])
• SakalisC ([email protected])
• Sam Stuewe ([email protected])
27
The BlackArch Linux Rehberi
• SanskritFritz ([email protected])
• Sarah Hay ([email protected])
• Sebastian Benvenuti ([email protected])
• Sebastian Nowicki ([email protected])
• Sebastien Duquette ([email protected])
• Sebastien LEDUC ([email protected])
• Sebastien Leduc ([email protected])
• Sergej Pupykin ([email protected])
• Sergio Rubio ([email protected])
• Sheng Yu ([email protected])
• Simon Busch ([email protected])
• Simon Legner ([email protected])
• Sirat18 ([email protected])
• SpepS ([email protected])
• Spider.007 ([email protected])
• Stefan Seering
• Stephane Travostino ([email protected])
• Stéphane Gaudreault ([email protected])
• Sven Kauber ([email protected])
• Sven Schulz ([email protected])
• Sébastien Duquette ([email protected])
• Sébastien Luttringer ([email protected])
• TDY ([email protected])
• Teemu Rytilahti ([email protected])
• Testuser_01
• Thanx ([email protected])
• Thayer Williams ([email protected])
• Thomas S Hatch ([email protected])
• Thorsten Töpper
• Tilmann Becker ([email protected])
28
The BlackArch Linux Rehberi
• Timothy Redaelli ([email protected])
• Timothée Ravier ([email protected])
• Tino Reichardt
• Tobias Kieslich ([email protected])
• Tobias Powalowski ([email protected])
• Tom K ([email protected])
• Tom Newsom ([email protected])
• Tomas Lindquist Olsen ([email protected])
• Travis Willard ([email protected])
• Valentin Churavy ([email protected])
• ViNS ([email protected])
• Vlatko Kosturjak ([email protected])
• Wes Brown ([email protected])
• William Rea ([email protected])
• Xavier Devlamynck ([email protected])
• Xiao
• Long Chen ([email protected])
• aeolist ([email protected])
• astaroth ([email protected])
• billycongo ([email protected])
• bslackr ([email protected])
• cbreaker ([email protected])
• chimeracoder ([email protected])
• damir ([email protected])
• danitool
• darkapex ([email protected])
• daronin
• dkaylor ([email protected])
29
The BlackArch Linux Rehberi
• dobo (dobo90_at_gmail@com)
• dorphell ([email protected])
• evr ([email protected])
• fnord0 ([email protected])
• fxbru (frxbru@gmail)
• hcar
• icarus ([email protected])
• iceman ([email protected])
• kastor ([email protected])
• kfgz ([email protected])
• linuxSEAT ([email protected])
• m4xm4n ([email protected])
• mar77i ([email protected])
• marc0s ([email protected])
• mickael9 ([email protected])
• nblock ([email protected])
• nofxx ([email protected])
• onny (onny@project
• pootzko ([email protected])
• revel ([email protected])
• rich_o ([email protected])
• s1gma ([email protected])
• sandman ([email protected])
• sebikul ([email protected])
• sh0 ([email protected])
• shild ([email protected])
• simo ([email protected])
• snuo
• sudokode ([email protected])
• tobias ([email protected])
30
The BlackArch Linux Rehberi
• trashstar ([email protected])
• unexist ([email protected])
• untitled ([email protected])
• virtuemood ([email protected])
• wido ([email protected])
• wodim ([email protected])
• yannsen ([email protected])
31